nanobot

nanobot is an agent framework - Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps.

Overview

🐈 nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. It runs in a WebUI, terminal, or chat apps and combines tools, long-term memory, MCP integrations, model routing, multi-agent delegation, scheduled automation, and an OpenAI-compatible API in a small, readable core.

• Persistent workflows: goals, memory, tools, and chat context survive long-running work. - Chat-native reach: WebUI, API, Telegram, Feishu, Slack, Discord, Teams, email, and Mattermost. - Model freedom: OpenAI-compatible APIs, local LLMs, image generation, search, and fallbacks. - Small core: readable internals with MCP, memory, deployment, and automation built in. - Own your stack: inspect, customize, self-host, and extend without a giant platform.

Prerequisites: Python 3.11 or newer. Git is only needed for a source install. Published packages already include the WebUI; a current-source install needs 'bun' or 'npm' to build it.

If terminals, API keys, or config files are new to you, use the guided zero-background walkthrough in Start Without Technical Background instead of this compact README path.

nanobot is open-source, written primarily in Python, with 46,386 GitHub stars under the MIT license. The latest release is v0.3.0 (2026-07-25).

Key capabilities

From the project's documentation:

• run in a browser WebUI or terminal
• connect to Telegram, Discord, Slack, WeChat, Email, Mattermost, and other chat apps
• use tools such as files, shell, web search, web fetch, MCP, cron, image generation, and subagents
• keep session history and long-term memory through Dream
• run long-horizon goals and scheduled automations
• expose a Python SDK and OpenAI-compatible API for integrations

Install

A quick way to get started (always check the official docs for the latest):

pip install nanobot-ai

How it fits a local-AI stack

nanobot runs on your own hardware, so pair it with a model and a GPU sized to your needs. Use the VRAM calculator to pick a model that fits your card, and see what you can run for hardware guidance. Related agent frameworks in the directory:

• "agentic-inbox"
• Agno
• "ai-agents-from-scratch"
• "aider"

Sources

• Source code & docs: HKUDS/nanobot
• Official website: https://nanobot.wiki

Stats from GitHub, 2026-07-30.