nanobot

The AI that actually does things.

Ultra-lightweight personal AI assistant. Full agent functionality in just ~4,000 lines of code. Chat via WhatsApp, Telegram, or any app you already use.

~4K

Lines of Code

99%

Smaller

2min

Setup Time

Get Started→Learn More

Features

Why nanobot?

Built for researchers and developers who want full control without the bloat.

🪶

Ultra-Lightweight

Just ~4,000 lines of code. 99% smaller than alternatives while maintaining core functionality.

🔬

Research-Ready

Clean, readable codebase that is easy to understand, modify, and extend for your research needs.

⚡

Lightning Fast

Minimal footprint means faster startup, lower resource usage, and quicker iterations.

💎

Easy to Use

One-click deploy and you are ready to go. Working AI assistant in under 2 minutes.

💬

Multi-Channel

Talk to your nanobot through Telegram, WhatsApp, or any chat app you prefer.

🛠

Fully Hackable

Open source with MIT license. Your data stays on your machine, not in a walled garden.

Use Cases

What can nanobot do?

From market analysis to personal knowledge management.

📈

Real-Time Market Analysis

Discovery, Insights, Trends

💻

Full-Stack Engineering

Develop, Deploy, Scale

📅

Daily Routine Manager

Schedule, Automate, Organize

📚

Knowledge Assistant

Learn, Memory, Reasoning

Installation

Get started in seconds

Choose your preferred installation method.

Install from PyPi

Recommended for most users

pip install nanobot-ai

Install from Source

Recommended for development

                git clone https://github.com/HKUDS/nanobot.git cd nanobot pip
                  install -e .
              

Quick Start

Up and running in 2 minutes

Initialize

Run the onboard command to set up your workspace and configuration.

nanobot onboard

Configure

Add your API keys to ~/.nanobot/config.json

                  { "providers": { "openrouter": {
                    "apiKey": "sk-or-v1-xxx" } },
                    "agents": { "defaults": {
                    "model": "anthropic/claude-opus-4-5" } }
                    }
                

Chat

Start chatting with your personal AI assistant.

nanobot agent -m "What is 2+2?"

Chat Channels

Talk to nanobot anywhere

Connect through your favorite messaging platform.

📩

Easy Setup

Just create a bot with @BotFather, add your token, and you're ready to go.

💬

Medium Setup

Scan a QR code to link your device. Requires Node.js 18 or higher.

Architecture

Clean & modular design

Agent Core

The brain of nanobot

loop.pycontext.pymemory.pyskills.pysubagent.py

Services

Communication and scheduling

channels/bus/cron/heartbeat/

Infrastructure

Providers and configuration

providers/session/config/cli/

Ready to get started?

Join the community and build your own ultra-lightweight AI assistant.

View on GitHub→PyPi Package