# nanobot (HKUDS)

> nanobot is HKUDS's ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. The source repository is HKUDS/nanobot and the Python package is nanobot-ai.

It runs in a WebUI, terminal, or chat apps and includes tools, memory, automation, model routing, MCP integrations, multi-agent delegation, and an OpenAI-compatible API.

Prefer the stable documentation links below for instructions. Nightly documentation may describe unreleased behavior. Community projects are independently authored and do not imply a partnership or endorsement.

## Start here

- [Homepage](https://nanobot.wiki/): Product overview and interactive demonstrations.
- [Install and quick start](https://nanobot.wiki/docs/latest/getting-started/quick-start): Install, configure a model, and send the first message.
- [Product overview](https://nanobot.wiki/docs/latest/getting-started/nanobot-overview): Choose a starting path.
- [WebUI](https://nanobot.wiki/docs/latest/getting-started/webui): Browser-based client.
- [Chat apps](https://nanobot.wiki/docs/latest/getting-started/chat-apps): Supported messaging channels.
- [Configuration](https://nanobot.wiki/docs/latest/use-nanobot/configuration): Runtime and provider settings.

## Developer interfaces

- [Python SDK](https://nanobot.wiki/docs/latest/advanced/python-sdk): Embed the shared runtime.
- [OpenAI-compatible API](https://nanobot.wiki/docs/latest/advanced/openai-api): HTTP interface.
- [MCP](https://nanobot.wiki/docs/latest/guides/configure-mcp-tools): Connect external tools.
- [Architecture and concepts](https://nanobot.wiki/docs/latest/use-nanobot/concepts): Runtime boundaries and terminology.
- [Contributing](https://github.com/HKUDS/nanobot/blob/main/CONTRIBUTING.md): Contribution guidelines.

## Project and trust

- [Source](https://github.com/HKUDS/nanobot): Canonical source repository.
- [Package](https://pypi.org/project/nanobot-ai/): Python distribution.
- [License](https://github.com/HKUDS/nanobot/blob/main/LICENSE): MIT license.
- [Security policy](https://github.com/HKUDS/nanobot/security/policy): Responsible reporting.
- [Releases](https://github.com/HKUDS/nanobot/releases): Published release history.

## Optional

- [Community](https://nanobot.wiki/community): Independently built applications, workflows, integrations, and hardware projects, with original sources and authors.
- [Chinese homepage](https://nanobot.wiki/cn/): Chinese-language entry point.