What do you want to do?
3 use cases
-
Set up a personal agent in your terminal
Install Nanobot, configure a model with the wizard and start chatting or running bounded goals.
View prompt
Install HKUDS/nanobot with `uv tool install nanobot-ai`, run `nanobot onboard --wizard` with <my model provider>, test with `nanobot -m "Hello!"`, and then open `nanobot webui`.
-
Run Nanobot on a server and use it from your laptop
Start the WebUI on a remote server without a browser and forward its port through SSH.
View prompt
Help me run HKUDS/nanobot on <my server>: install it, start `nanobot webui --no-open`, and give me the exact `ssh -N -L 127.0.0.1:8765:127.0.0.1:8765 user@SERVER` command with my host filled in.
-
Keep Nanobot running for chat apps and automations
Run the gateway in the background so Telegram, Slack or Discord channels and scheduled automations keep working.
View prompt
With HKUDS/nanobot, connect my Telegram account as a channel restricted to my user only, start `nanobot gateway --background`, and show me `nanobot gateway status`.
Quick start with Nanobot
- Check you have what it needs: Python with uv or pip; install with `uv tool install nanobot-ai`; A model provider configured through the onboarding wizard, or a local LLM; Optional chat app accounts such as Telegram or Slack for channels.
- Open HKUDS/nanobot on GitHub and read the README and license.
- Install with
uv tool install nanobot-aiand verify withnanobot --version - Configure a model with
nanobot onboard --wizard - Check one reply with
nanobot -m "Hello!", then open the terminal client withnanobotor the browser withnanobot webui - Give it a bounded objective such as
/goal Review this project's tests and list the smallest missing test case.
These steps come from our top use case, Set up a personal agent in your terminal, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for HKUDS/nanobot
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forIndividuals and small teams who want a self-hosted personal agent reachable from their chat apps.
- Why it is hot50k stars, talked about in 2 AI sources we track
- LanguagePython
- Sourcegithub.com/HKUDS/nanobot ยท Back to Hot repos
Requirements
- Python with uv or pip; install with `uv tool install nanobot-ai`
- A model provider configured through the onboarding wizard, or a local LLM
- Optional chat app accounts such as Telegram or Slack for channels
Add this badge to your README
Maintain Nanobot? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/hkuds-nanobot/?utm_source=github&utm_medium=badge&utm_campaign=HKUDS-nanobot)
HTML
<a href="https://dedupedai.com/use-cases/hkuds-nanobot/?utm_source=github&utm_medium=badge&utm_campaign=HKUDS-nanobot"><img src="https://dedupedai.com/badge/HKUDS/nanobot.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Nanobot
What is Nanobot?
nanobot is a lightweight open source personal agent that runs in a browser WebUI or terminal and connects to Telegram, Discord, Slack, WeChat, Email, Mattermost, Linear and other channels. It reads PDF, Word, Excel and PowerPoint files, uses shell, web search, MCP integrations, cron and multi-agent delegation, keeps long-term memory, and runs as a background gateway. It is an open-source project on GitHub: https://github.com/HKUDS/nanobot.
How do I use Nanobot?
Install with uv tool install nanobot-ai and verify with nanobot --version; then configure a model with nanobot onboard --wizard; check one reply with nanobot -m "Hello!", then open the terminal client with nanobot or the browser with nanobot webui. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Nanobot for?
Individuals and small teams who want a self-hosted personal agent reachable from their chat apps.
What can I do with Nanobot?
3 use cases so far, for example: Set up a personal agent in your terminal; Run Nanobot on a server and use it from your laptop; Keep Nanobot running for chat apps and automations. Each has steps and a copy-paste agent prompt.
What do I need to run Nanobot?
Python with uv or pip; install with `uv tool install nanobot-ai`; A model provider configured through the onboarding wizard, or a local LLM; Optional chat app accounts such as Telegram or Slack for channels.
What are alternatives to Nanobot?
Other hot AI repos in Personal productivity: Textgen, Learnharness, Chatbox, Jan, Planning with Files.
Is Nanobot safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.