{"name":"nanobot: An Ultra-Lightweight, Self-Hosted Personal AI Agent Framework","description":"nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework built in Python. It offers a WebUI, tools, memory, multi-agent workflows, and automation capabilities, making it a versatile solution for personal AI tasks. Users can deploy it across various platforms, including chat apps, for seamless integration.","github":"https://github.com/HKUDS/nanobot","url":"https://osrepos.com/repo/hkuds-nanobot","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/hkuds-nanobot","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/hkuds-nanobot.md","json":"https://osrepos.com/repo/hkuds-nanobot.json","topics":["ai-agent","agent-framework","python","self-hosted","llm-agents","multi-agent","workflow-automation","personal-ai-assistant"],"keywords":["ai-agent","agent-framework","python","self-hosted","llm-agents","multi-agent","workflow-automation","personal-ai-assistant"],"stars":null,"summary":"nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework built in Python. It offers a WebUI, tools, memory, multi-agent workflows, and automation capabilities, making it a versatile solution for personal AI tasks. Users can deploy it across various platforms, including chat apps, for seamless integration.","content":"## Introduction\n\nnanobot is an innovative, ultra-lightweight, and open-source personal AI agent framework developed in Python. Designed for self-hosting, it provides a comprehensive suite of features including a WebUI, various tools, long-term memory, Model Context Protocol (MCP) integrations, multi-agent workflows, and scheduled automation. Whether you prefer a browser interface, a terminal, or integration with popular chat applications, nanobot offers a flexible and powerful platform for managing your AI agents.\n\n## Installation\n\nGetting started with nanobot requires Python 3.11 or newer. For the most stable experience, installation from PyPI or using `uv` is recommended. If you prefer the latest features, you can install from source.\n\n**One-command setup (macOS / Linux):**\n\nbash\ncurl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh\n\n\n**One-command setup (Windows PowerShell):**\n\npowershell\nirm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex\n\n\nAlternatively, you can install using `uv` or `pip`:\n\n**Install with `uv`:**\n\nbash\nuv tool install nanobot-ai\n\n\n**Install from PyPI with pip:**\n\nbash\npython -m pip install nanobot-ai\n\n\nFor detailed instructions, including source installation and troubleshooting, please refer to the [official documentation](https://nanobot.wiki/docs/latest/getting-started/nanobot-overview){:target=\"_blank\"}.\n\n## Examples\n\nOnce installed, nanobot offers several ways to interact with your AI agent.\n\n**Open nanobot in your browser (recommended first run):**\n\nbash\nnanobot webui\n\n\nThis command launches the WebUI, allowing you to configure models and start new topics.\n\n**For a quick, one-shot interaction in the terminal:**\n\nbash\nnanobot agent -m \"Hello!\"\n\n\nThis is useful for quick checks or integrating into shell scripts. You can also run the gateway in the background or interact entirely within the terminal.\n\n## Why Use nanobot?\n\nnanobot stands out due to several key advantages:\n\n*   **Persistent Workflows:** It ensures that goals, memory, tools, and chat context endure across long-running tasks.\n*   **Chat-Native Reach:** With support for WebUI, API, Telegram, Discord, Slack, WeChat, email, and Mattermost, nanobot is accessible wherever you communicate.\n*   **Model Freedom:** It supports OpenAI-compatible APIs, local LLMs, image generation, search, and fallback models, giving you control over your AI backend.\n*   **Small Core:** Its readable internals, with built-in MCP, memory, deployment, and automation, make it easy to understand and extend.\n*   **Own Your Stack:** You have the freedom to inspect, customize, self-host, and extend the framework without reliance on a large platform.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/HKUDS/nanobot](https://github.com/HKUDS/nanobot){:target=\"_blank\"}\n*   **Official Documentation:** [https://nanobot.wiki/docs/latest/getting-started/nanobot-overview](https://nanobot.wiki/docs/latest/getting-started/nanobot-overview){:target=\"_blank\"}\n*   **Discord Community:** [https://discord.gg/MnCvHqpUGB](https://discord.gg/MnCvHqpUGB){:target=\"_blank\"}\n*   **X (formerly Twitter):** [https://x.com/nanobot_project](https://x.com/nanobot_project){:target=\"_blank\"}","metrics":{"detailViews":1,"githubClicks":0},"dates":{"published":null,"modified":"2026-08-09T08:07:50.000Z"}}