nanobot

nanobot is a lightweight AI agent configured by a single config.json. Built on uv-managed Python, install and start are both one-liners.

Prerequisites

Item	Requirement
uv	Installed
WRouter	A working sk- token

Install

uv tool install nanobot-ai

Windows extra step

Add %USERPROFILE%\.local\bin to PATH so nanobot is callable:

$env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"

Persist by adding to your PowerShell Profile.

Verify install

nanobot --version

Configure

1. Generate default config

nanobot onboard

Writes the config to:

• Linux / macOS: ~/.nanobot/config.json
• Windows: %USERPROFILE%\.nanobot\config.json

2. Edit config.json

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-6",
      "provider": "wrouter"
    }
  },
  "providers": {
    "wrouter": {
      "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "apiBase": "https://wrouter.ai/v1"
    }
  }
}

Field notes:

Field	Note
apiBase	Must end in /v1
model	Must match WRouter's model ID exactly
provider (under defaults)	Refers to the key under providers

Multiple providers can live in parallel; agents.defaults.provider picks the default.

Start

nanobot agent

Ask anything; a response means it works.

Switch models

Edit agents.defaults.model and restart nanobot agent.

Known limitations

• nanobot is minimal by design; advanced agent orchestration features live in other agents like Hermes or AionUi.