smanx/nanobot repository overview

🐈 nanobot is an ultra-lightweight personal AI assistant inspired by OpenClaw⁠

⚡️ Delivers core agent functionality in just ~4,000 lines of code — 99% smaller than Clawdbot's 430k+ lines.

📏 Real-time line count: 3,510 lines (run bash core_agent_lines.sh to verify anytime)

⁠Key Features of nanobot:

🪶 Ultra-Lightweight: Just ~4,000 lines of core agent code — 99% smaller than Clawdbot.

🔬 Research-Ready: Clean, readable code that's easy to understand, modify, and extend for research.

⚡️ Lightning Fast: Minimal footprint means faster startup, lower resource usage, and quicker iterations.

💎 Easy-to-Use: One-click to deploy and you're ready to go.

# Initialize config (first time only)
docker run -v ~/.nanobot:/root/.nanobot --rm smanx/nanobot nanobot onboard

# Edit config on host to add API keys
vim ~/.nanobot/config.json

# Run gateway (connects to Telegram/WhatsApp)
docker run -v ~/.nanobot:/root/.nanobot -p 18790:18790 smanx/nanobot
# or
docker run -v ~/.nanobot:/root/.nanobot -p 18790:18790 \
  -e NANOBOT_DEFAULT_MODEL=... \
  -e OPENAI_API_BASE=... \
  -e OPENAI_API_KEY=... \
  smanx/nanobot



# Or run a single command
docker run -v ~/.nanobot:/root/.nanobot --rm smanx/nanobot nanobot agent -m "Hello!"
docker run -v ~/.nanobot:/root/.nanobot --rm smanx/nanobot nanobot status

⁠Environment Variables

⁠Related Links

• Official Documentation: https://github.com/HKUDS/nanobot⁠
• Original Project: https://github.com/HKUDS/nanobot⁠