HKUDS/nanobot
Your lightweight open-source personal agent.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
🐈 nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. Use it in a browser, terminal, or chat app to work with files, remember preferences, and schedule tasks. Connect a supported model provider or local model server to supply the AI. nanobot can: You need Python 3.11 or newer and access to a supported model provider or local model server. Model fees or local hardware requirements depend on the service you choose; nanobot does not supply a model account. Choose the stable release for everyday use or current source for development and the latest features. This README describes current source; published documentation covers the released version. New to terminals or model credentials? Follow Start Without Technical Background. Updating an existing instance? Follow updates and recovery for your installation method, backup steps and restart checks. Stable release: automatic setup (recommended) The installer chooses an isolated Python environment…
Read the full README ↗ · Preview checked 2026-10-31T05:42:09.336Z
Inside the original README — Document outline
- nanobot
- Start Here
- What can nanobot do?
- 💡 Why nanobot
- 📦 Install
- 🚀 Quick Start
- ☁️ Deploy
- 🌐 WebUI
- Keep related work side by side
- Inspect the work and its context
- Bring your tools into the conversation
- Let recurring work run on a schedule
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
Your lightweight open-source personal agent.
Repository facts
- Owner
- HKUDS
- Primary language
- Python
- Stars
- 49,697
- Forks
- 8,702
- Open issues + pull requests
- 867
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-02-01T07:16:15.000Z
- Last push
- 2026-10-31T03:55:14.000Z
Topics and intended use
Owner-supplied topics: agent-framework, ai-agent, ai-agents, chatbot, chatops, discord-bot, llm-agents, llms, local-llm, mcp, model-context-protocol, multi-agent, openai-compatible, openclaw, personal-ai-assistant, python, self-hosted, telegram-bot-ai-assistant, webui, workflow-automation
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-31T12:20:20.933Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.
Related repositories
EbookFoundation/free-programming-books
donnemartin/system-design-primer