Choose your installation method and get started
Three installation methods, one ultra-lightweight AI assistant
The nano bot has minimal system requirements. If your system runs Python 3.10+, you can run nanobot ai without issue.
The nanobot requires Python 3.10 or higher. This version introduced features that the nano bot depends on for its architecture. Check your version with python --version.
Install Python: python.org/downloads
Linux: All major distributions (Ubuntu, Debian, Fedora, Arch, etc.)
macOS: Intel and Apple Silicon supported
Windows: Windows 10, Windows 11
The nanobot ai is pure Python and platform-independent.
RAM: Approximately 100MB (estimated)
Disk: Minimal space for code and dependencies
The nano bot is 10x more memory-efficient than OpenClaw's ~1GB RAM usage. Perfect for low-spec systems and cloud deployment.
Internet: Required for LLM API calls and messaging platforms
Bandwidth: Minimal data usage
The nanobot ai needs connectivity for cloud LLM providers. Local models via vLLM reduce network dependency.
The recommended installation method for most users. Install the nano bot from PyPI for stable, tested releases of nanobot ai.
pip install nanobot-ai
python --version)pip install nanobot-aipython -c "import nanobot"Stable Releases: Only tested versions published
Easy Updates: pip install --upgrade nanobot-ai
Official Package: Maintained by HKUDS
Dependency Management: Automatic
python -m venv nanobot-env
source nanobot-env/bin/activate # Linux/Mac
nanobot-env\Scripts\activate # Windows
pip install nanobot-ai
Use virtual environments to isolate the nano bot installation from other Python projects.
View the nanobot ai package on PyPI for version history, dependencies, and download statistics:
Current Version: v0.1.3.post7 (2026-02-13)
Install the nano bot using uv, an ultra-fast Python package installer. Same stable releases as PyPI, but with dramatically faster installation speeds.
uv tool install nanobot-ai
uv is a next-generation Python package installer written in Rust. It's 10-100x faster than pip for package installation. Perfect for quickly setting up the nanobot ai.
Install uv: github.com/astral-sh/uv
curl -LsSf https://astral.sh/uv/install.sh | shuv tool install nanobot-aiSpeed: 10-100x faster than pip
Reliability: Better dependency resolution
Same Packages: Uses PyPI, same nanobot versions
Modern: Built with Rust for performance
Both install the same nanobot ai package from PyPI. The difference is speed and tooling. Use uv if you want blazing-fast installations. Use pip for maximum compatibility.
Install the nano bot directly from the GitHub repository for the latest development version. Best for developers, contributors, and those who want cutting-edge nanobot ai features.
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .
git --version)git clone https://github.com/HKUDS/nanobot.gitcd nanobotpip install -e .Latest Features: Get unreleased improvements
Development: Modify and test changes
Contributing: Required for pull requests
Learning: Read the ~4,000 lines of nanobot code
cd nanobot
git pull origin main
pip install -e .
Pull the latest changes from the nanobot ai repository and reinstall. The -e flag keeps the installation linked to your local source.
The nanobot source code is hosted on GitHub by HKUDS (Data Intelligence Lab @ HKU):
Stars: 17,800+ | Forks: 2,600+
After installing the nano bot, verify the installation was successful and check which version of nanobot ai you have.
python -c "import nanobot; print(nanobot.__version__)"
This should print the nanobot version number (e.g., v0.1.3.post7). If you see a version number, the nano bot is installed correctly.
python -c "import nanobot; print('nanobot installed successfully!')"
Simple import test for the nanobot ai. If this runs without errors, your installation is working.
pip list | grep nanobot
Shows the nanobot package in your pip installed packages. Useful for confirming the nano bot is in your Python environment.
After installing the nano bot, you need to configure LLM providers, messaging platforms, and other settings. The nanobot ai uses configuration files for all settings.
The nanobot stores configuration in your home directory or project directory. Create configuration files for:
Configure at least one LLM provider for the nano bot. Supported providers include:
Add your API keys to the nanobot ai configuration.
Set up messaging platforms for the nanobot:
For complete configuration instructions including example config files, credential setup, and best practices, see our comprehensive guide:
Keep your nano bot installation up to date with the latest features, bug fixes, and improvements from HKUDS.
pip install --upgrade nanobot-ai
Upgrades the nanobot to the latest stable version on PyPI. Run this periodically to get the newest nano bot features.
uv tool upgrade nanobot-ai
If you installed with uv, use this command to upgrade the nanobot ai. Faster than pip for updates.
cd nanobot
git pull
pip install -e .
Pull the latest changes from the nano bot repository and reinstall. Gets you the absolute latest development code.
v0.1.3.post7 (2026-02-13): Latest stable release with security improvements
2026-02-12: Memory system redesign for reliability
2026-02-09: Added Slack, Email, QQ platform support
2026-02-02: Initial nanobot release by HKUDS
View complete changelog: GitHub Releases
If you need to remove the nano bot from your system, the process is straightforward regardless of installation method.
pip uninstall nanobot-ai
Removes the nanobot package from your Python environment. Confirm when prompted. This works for both PyPI and source installations.
uv tool uninstall nanobot-ai
If you installed the nano bot with uv, use this command to remove it cleanly from your system.
After uninstalling nanobot ai, you may want to remove configuration files, memory data, and logs. These are typically stored in:
~/.nanobot/ or project directoryMEMORY.md and memory/ directorylogs/ or system temp directoryIf you installed from source, delete the cloned repository:
rm -rf nanobot/
This removes all nano bot source code from your local system.
Now that the nano bot is installed, configure your LLM providers and messaging platforms, then start your first conversation. The nanobot ai journey begins here.