# AI use cases for Nanobot (HKUDS/nanobot)

Repo: [HKUDS/nanobot](https://github.com/HKUDS/nanobot) | Use cases: 3 | Page: https://dedupedai.com/use-cases/hkuds-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.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Set up a personal agent in your terminal: https://dedupedai.com/use-cases/hkuds-nanobot/set-up-a-personal-agent-in-the-terminal-with-nanobot/
- Run Nanobot on a server and use it from your laptop: https://dedupedai.com/use-cases/hkuds-nanobot/run-nanobot-on-a-server-and-reach-it-over-ssh/
- Keep Nanobot running for chat apps and automations: https://dedupedai.com/use-cases/hkuds-nanobot/connect-nanobot-to-telegram-with-a-background-gateway/

## How to set up a personal agent in your terminal with Nanobot

Repo: [HKUDS/nanobot](https://github.com/HKUDS/nanobot) | Difficulty: Beginner | Time: 20 minutes | Basis: From the README

Install Nanobot, configure a model with the wizard and start chatting or running bounded goals.

**Who it is for:** Someone who wants their own agent without a heavy platform.

**The problem:** Hosted assistants keep your history and memory on their servers.

**The outcome:** A working Nanobot that answers in the terminal or WebUI and keeps long-term memory.

### Steps

1. Install with `uv tool install nanobot-ai` and verify with `nanobot --version`
2. Configure a model with `nanobot onboard --wizard`
3. Check one reply with `nanobot -m "Hello!"`, then open the terminal client with `nanobot` or the browser with `nanobot webui`
4. Give it a bounded objective such as `/goal Review this project's tests and list the smallest missing test case.`

### Prompt to paste into your agent

```text
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`.
```

### Caveat

The README's one line installers pipe a remote script into sh or iex; use `--dry-run` to preview them, or the uv or pip install instead.

Risk, permissions: Nanobot can use shell tools on the machine it runs on; review its security configuration before giving it broad goals.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/hkuds-nanobot/set-up-a-personal-agent-in-the-terminal-with-nanobot/

## How to run Nanobot on a server and use it from your laptop with Nanobot

Repo: [HKUDS/nanobot](https://github.com/HKUDS/nanobot) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Start the WebUI on a remote server without a browser and forward its port through SSH.

**Who it is for:** A user who wants the agent always on, on a home server or VPS.

**The problem:** A laptop agent stops working when the lid closes.

**The outcome:** A server-side Nanobot WebUI reachable safely through an SSH tunnel.

### Steps

1. Install Nanobot on the server with `uv tool install nanobot-ai`
2. Start the WebUI there with `nanobot webui --no-open`
3. On your computer forward the port with `ssh -N -L 127.0.0.1:8765:127.0.0.1:8765 user@SERVER`
4. Open the forwarded WebUI locally and finish model setup

### Prompt to paste into your agent

```text
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.
```

### Caveat

Keep the server terminal running while you use the tunnel, or switch to the background gateway.

Risk, security: Keep the WebUI bound to localhost and reach it through the SSH tunnel rather than exposing the port to the internet.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/hkuds-nanobot/run-nanobot-on-a-server-and-reach-it-over-ssh/

## How to keep Nanobot running for chat apps and automations with Nanobot

Repo: [HKUDS/nanobot](https://github.com/HKUDS/nanobot) | Difficulty: Intermediate | Time: 45 minutes | Basis: From the README

Run the gateway in the background so Telegram, Slack or Discord channels and scheduled automations keep working.

**Who it is for:** A user who wants to message their agent from their phone and run cron style automations.

**The problem:** Channels and automations stop when the interactive launcher closes.

**The outcome:** A background gateway serving chat channels and scheduled automations, with logs you can check.

### Steps

1. Configure a model first with `nanobot onboard --wizard`
2. Ask Nanobot in the WebUI to help connect Telegram and allow only your account, as the README suggests
3. Start the gateway with `nanobot gateway --background`
4. Manage it with `nanobot gateway status`, `nanobot gateway logs` and `nanobot gateway stop`

### Prompt to paste into your agent

```text
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`.
```

### Caveat

Exact channel settings are in the README's linked chat app guide and channel reference.

Risk, permissions: Before connecting a bot to shared channels, check each platform's DM pairing, allowlist and group access policies; the README warns that approving a private sender does not restrict group access everywhere.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/hkuds-nanobot/connect-nanobot-to-telegram-with-a-background-gateway/
