nanobot

Your lightweight open-source personal agent.

What is nanobot?

Your lightweight open-source personal agent.

Overview of nanobot

What it is

nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. It can be used in a browser, terminal, or chat app to work with files, remember preferences, and schedule tasks. A supported model provider or local model server is required to supply the AI.

Key features

  • Runs in a browser WebUI or terminal
  • Connects to Telegram, Discord, Slack, WeChat, Email, Mattermost, Linear, and other channels
  • Reads PDF, Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files with built-in file tools
  • Uses shell, web search/fetch, MCP integrations, cron, image generation, and multi-agent delegation
  • Keeps session history and long-term memory through Dream
  • Runs long-horizon goals and scheduled automations
  • Exposes a Python SDK and OpenAI-compatible API for integrations

Use cases

  • Summarizing reports from PDF, Word, Excel, or PowerPoint files
  • Running persistent workflows with saved conversations and long-term memory
  • Connecting AI to multiple chat platforms (Telegram, Discord, Slack, etc.)
  • Automating tasks with cron and scheduled goals
  • Integrating with other applications via Python SDK or OpenAI-compatible API

Getting started

You need Python 3.11 or newer and access to a supported model provider or local model server. For the stable release, run one of the following commands:macOS / Linuxbashcurl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | shWindows PowerShellpowershellirm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iexFor alternative installation methods (uv, pip, or source checkout), see the repository README.

License and pricing

This project is licensed under the MIT License and is open source. No pricing information is provided beyond the open-source nature.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/hkudsnanobot.svg)](https://yunodb.com/tools/hkudsnanobot?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/hkudsnanobot?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/hkudsnanobot.svg" alt="Featured on YunoDB" height="20"></a>