Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions agents/HKUDS__nanobot/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# nanobot 🐈

**nanobot** is an open-source, ultra-lightweight AI agent framework in the spirit of Claude Code, OpenClaw, and Codex. It keeps the core agent loop small and readable while delivering a production-ready personal agent experience.

## What it does

nanobot receives messages from chat channels, invokes an LLM of your choice, executes tools, and responds — all with persistent session memory and a minimal footprint.

## Key capabilities

- **15+ chat channels** — Telegram, Discord, Slack, WhatsApp, Feishu, Matrix, WeChat, WeCom, DingTalk, MS Teams, QQ, Email, MoChat, WebSocket
- **Rich tool suite** — filesystem (read/write/edit), sandboxed shell, web search & fetch, MCP servers, cron scheduling, image generation, audio transcription, sub-agent spawning, notebook editing
- **Persistent memory** — Dream two-phase memory consolidation with atomic session writes and TTL-based auto-compaction
- **Long-horizon goals** — `/goal` command sustains objectives across many turns with visible multi-step progress
- **Multi-provider** — Anthropic Claude, OpenAI, Azure OpenAI, AWS Bedrock, GitHub Copilot, DeepSeek, NVIDIA NIM, Hugging Face, Ollama, and more — with automatic fallback
- **WebUI** — Vite/React SPA bundled inside the Python wheel; communicates over WebSocket multiplex
- **OpenAI-compatible API** — `/v1/chat/completions` endpoint for programmatic access
- **Plugin system** — channels and tools are auto-discovered via `pkgutil` and entry-point plugins

## Installation & quick start

```bash
pip install nanobot-ai
nanobot setup # interactive wizard — pick your provider and model
nanobot gateway # start the gateway (Telegram, Discord, Slack, etc.)
nanobot # or run in terminal mode
```

## Architecture

Messages flow through an async `MessageBus` that decouples channels from the agent core. The `AgentLoop` manages session keys and context; the `AgentRunner` executes the multi-turn LLM conversation with tool calls. Every capability lives at the edge (channels, tools, MCP) — the core stays small.

## Links

- GitHub: https://github.com/HKUDS/nanobot
- Docs: https://nanobot.wiki
- PyPI: https://pypi.org/project/nanobot-ai/
- License: MIT
15 changes: 15 additions & 0 deletions agents/HKUDS__nanobot/metadata.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"name": "nanobot",
"author": "HKUDS",
"description": "Ultra-lightweight open-source AI agent with multi-channel support (Telegram, Discord, Slack, WhatsApp, and more), MCP, memory, cron, image generation, and long-horizon goals.",
"repository": "https://github.com/HKUDS/nanobot",
"path": "",
"version": "0.2.0",
"category": "developer-tools",
"tags": ["ai-agent", "llm", "multi-channel", "mcp", "anthropic", "openai", "memory", "python", "chatbot", "open-source"],
"license": "MIT",
"model": "claude-sonnet-4-5-20250929",
"adapters": ["claude-code", "system-prompt"],
"icon": false,
"banner": false
}
Loading