HKUDS/nanobot

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

What it solves

nanobot is a self-hosted personal AI agent framework designed to provide a lightweight, private alternative to giant AI platforms. It solves the problem of maintaining persistent AI workflows—where goals, memory, and chat context survive across long-running tasks—while allowing users to own their entire stack, including the choice of LLM providers and the interfaces they use to interact with the agent.

How it works

The project centers around a small agent loop that manages messages from various interfaces and uses an LLM to determine when tools are needed. It integrates several key components:

  • Interfaces: Users can interact with the agent via a bundled WebUI, a native terminal client (TUI), or integrated chat apps like Telegram, Discord, Slack, and WeChat.
  • Tooling & Integration: It supports Model Context Protocol (MCP) servers, shell access, web search, and image generation.
  • Memory: It utilizes a system called "Dream" for session history and long-term memory.
  • Automation: It includes a gateway that can run long-horizon goals and scheduled automations in the background.
  • Connectivity: It exposes an OpenAI-compatible API and a Python SDK for external integrations.

Who it’s for

It is intended for individuals who want a self-hosted AI agent that can be extended and customized, ranging from non-technical users (via guided installation) to developers who want to a programmable agent gateway for their local environment.

Highlights

  • Multi-channel reach: Connects to a wide variety of chat apps (Telegram, Discord, Slack, etc.) and a browser-based WebUI.
  • Model freedom: Supports OpenAI-compatible APIs, local LLMs (via Ollama, vLLM), and fallback models.
  • ** uma lightweight core**: Readable internals that avoid heavy orchestration layers.
  • Persistent Workflows: Supports scheduled automations and long-term memory.
  • Workbench UI: A WebUI that allows grouping multiple conversations side-by-side in a grid or columns.

Related

  • Project
  • Project
  • Project
  • Project
  • Project