Verified project record

HKUDS/nanobot

A self-hosted personal AI agent runtime for integrating chat channels, tools, memory, and automations. It provides a small, extensible core that runs locally or on a server and requires an OpenAI-compatible LLM provider.

Project overview

Project type: MCP · AI Agent · Workflow
Use cases: Knowledge Q&A · Automation
Deployment: Refer to project documentation
License: MIT

Best for

Developers and AI engineers who need a self-hosted, extensible agent core for personal knowledge base delivery and workflow automation.

Key capabilities

Ships a browser workbench for chat sessions, workspace controls, Apps, Skills, Automations, and settings inside the published wheel.
Connects to Telegram, Discord, Slack, WeChat, Email, Mattermost, and other chat apps to run agent interactions.
Provides files, shell, web search, web fetch, MCP, cron, image generation, and subagents for agent tasks.
Keeps session history and long-term memory through Dream to preserve context.
Runs long-horizon goals and scheduled automations.
Exposes an OpenAI-compatible API for integrations.
Exposes a Python SDK for integrations and runtime controls.
Supports local LLMs, image generation, search, and model fallbacks.

Limitations and risks

Requires Python 3.11 or newer.
Building from source requires additional npm or bun steps which might fail on Windows.

Getting started

Run the installer via curl or PowerShell, use the guided onboard wizard, configure an API key, and launch the WebUI.

Evidence and sources

GitHub project description: Lightweight, open-source AI agent for your tools, chats, and workflows.
README: Install nanobot with no terminal/config background
README: nanobot is a self-hosted personal AI agent runtime. It can: - run in a browser WebUI or terminal - connect to Telegram, Discord, Slack, WeChat, Email, Mattermost, and other chat a…
README: v0.2.2 - Durability Release Highlights: - Segmented WebUI transcripts - Python SDK runtime controls - Automation management - Search/STT provider improvements - Gateway/session/pr…
README: 2026-07-10 Stable model routing, multiline CLI input, new automation guide.

Reviewed at: 2026-07-17T07:26:45Z