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
47 changes: 47 additions & 0 deletions agents/HKUDS__nanobot/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# nanobot

**nanobot** is a lightweight, open-source AI agent framework by the HKUDS lab,
built in the spirit of Claude Code and OpenClaw. It keeps the core agent loop
small and readable while supporting everything you need to deploy a practical,
long-running personal or team agent.

## What it does

- **Multi-channel presence** — connect to Telegram, Discord, Slack, WhatsApp,
Feishu, WeChat, DingTalk, Matrix, Email, MS Teams, WeCom, and more from a
single running instance.
- **Pluggable LLM providers** — Anthropic, OpenAI, Azure, AWS Bedrock, GitHub
Copilot, OpenRouter, Ollama, and many more via a provider registry with
automatic fallback.
- **Rich built-in toolset** — sandboxed shell execution, filesystem read/write/edit,
web search & fetch, MCP server connections, cron scheduling, notebook editing,
image generation, and subagent spawning.
- **Sustained goals** — `/goal` holds a long-horizon objective across turns, with
automatic progress tracking via the heartbeat cron system.
- **Dream memory** — two-phase memory consolidation distils session history into
durable, searchable memories that shape future context without growing the
context window unboundedly.
- **OpenAI-compatible API** — exposes `/v1/chat/completions` so any OpenAI-SDK
client can talk to a running nanobot instance.
- **WebUI** — a Vite/React single-page app ships inside the Python wheel for
browser-based interaction.

## Quick start

```bash
pip install nanobot-ai
nanobot setup # interactive wizard — pick provider, model, and channels
nanobot gateway # start the agent
```

## Key stats

- ⭐ 43 000+ GitHub stars
- 🐍 Python 3.11+, asyncio throughout
- 📦 MIT licensed

## Links

- **Repo**: https://github.com/HKUDS/nanobot
- **Docs**: https://nanobot.wiki
- **Releases**: https://github.com/HKUDS/nanobot/releases
13 changes: 13 additions & 0 deletions agents/HKUDS__nanobot/metadata.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
{
"name": "nanobot",
"author": "HKUDS",
"description": "Lightweight open-source AI agent framework with a small readable loop, multi-channel chat (Telegram, Discord, Slack, WhatsApp, etc.), MCP, cron, memory, and a rich built-in toolset.",
"repository": "https://github.com/HKUDS/nanobot",
"version": "0.2.0",
"category": "developer-tools",
"tags": ["ai-agent", "multi-channel", "mcp", "telegram", "discord", "memory", "open-source", "python", "self-hosted"],
"license": "MIT",
"model": "anthropic:claude-sonnet-4-6",
"adapters": ["claude-code", "openai", "system-prompt"],
"icon": false
}