⚡ Codex SkillsClaude CodeCodexMCP

nanobot

Lightweight, open-source AI agent for your tools, chats, and workflows.

HKUDSPythongit

View on GitHub

Overview

Review nanobot through its repository signals, setup path, and structured documentation.

Key Features

Documentation available at https://nanobot.wiki/docs/latest/getting-started/nanobot-overview
Built around python tooling

Best For

Codex Skill research

Keep exploring from this skill

Use these paths to move from a single repository into the broader category, platform, and workflow hubs that users usually compare next.

Install

uv tool install nanobot-ai

Repository

Stars

45,185

Forks

7,980

[!IMPORTANT] If you want the newest features and experiments, install from source.

If you want the most stable day-to-day experience, install from PyPI or with uv.

Pick one install method:

Prerequisites: Python 3.11 or newer. Git is only needed for a source install; Node.js/Bun are only needed if you are developing the WebUI itself.

If terminals, API keys, or config files are new to you, use the guided zero-background walkthrough in Start Without Technical Background instead of this compact README path.

One-command setup

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex

The default command installs or upgrades nanobot-ai from PyPI, then starts nanobot onboard --wizard. It avoids system-wide pip installs by using an active virtual environment, uv, pipx, or a managed venv under ~/.nanobot/venv. If Quick Start finishes, skip the manual initialize/configure steps below and go straight to Open the WebUI.

To preview the plan without changing your environment, pass --dry-run; combine it with --dev when you want to preview the main-branch install.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

🌐 WebUI

The WebUI ships inside the published wheel — no extra build step. It is the browser workbench for chat sessions, workspace controls, Apps, Skills, Automations, and settings. For the full user guide, see docs/webui.md.

Open it

nanobot webui

The command enables the local WebSocket channel after confirmation, starts the gateway, and opens http://127.0.0.1:8765. To open it from another device on your LAN, see WebUI docs -> LAN access.

The WebUI is served by the WebSocket channel on port 8765 by default. The gateway's 18790 port is for the health endpoint, not the browser UI.

[!TIP] Working on the WebUI itself? Check out webui/README.md for the source-tree, Vite dev server, build, and test workflow.

Requirements

python runtime or toolinguv compatible environmentan MCP-compatible host

Trust Signals

FeaturedVerifiedDocs AvailableHomepage Available

You want to...	Go to
Install nanobot with no terminal/config background	Start Without Technical Background
Install quickly and get one CLI reply	Install and Quick Start
Open the bundled browser UI	WebUI
Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, or another chat app	Chat Apps
Configure providers, fallback models, Langfuse, MCP, web tools, or security	Docs and Configuration
Understand or extend the internals	Architecture and Development

nanobot

What the docs cover

Keep exploring from this skill

Related Skills

graphify

skills

codeburn