Nanobot Setup und erster Start

1. Was dir die Installation tatsächlich bringt

Das Upstream-Repo bietet derzeit drei praktische Installationspfade:

uv tool install nanobot-ai

python -m pip install nanobot-ai

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
python -m pip install -e .

Es gibt außerdem einen Ein-Befehl-Installer im Verzeichnis scripts/ des Repos für Leute, die den projektverwalteten Bootstrap-Pfad wollen.

2. Die Installation verifizieren

Nach der Installation ist die einfachste Funktionsprüfung:

nanobot --version

Das bestätigt, dass die CLI in deinem Pfad liegt, bevor du anfängst, Anbieter-Keys oder Workflow-Konfiguration zu debuggen.

3. Welchen Installationspfad du wählen solltest

Pfad	Am besten, wenn
uv tool install nanobot-ai	Du die sauberste lokale CLI-Installation willst
pip install nanobot-ai	Du deine Python-Umgebungen bereits selbst verwaltest
editierbare Source-Installation	Du den Code sofort lesen oder ändern willst

Wenn pip über eine extern verwaltete Umgebung meckert, empfiehlt die Upstream-Anleitung, uv, pipx oder eine dedizierte virtuelle Umgebung zu nutzen, statt eine Systeminstallation zu erzwingen.

4. Docker- und dienstartige Setups

Das Repo liefert außerdem Dockerfile, docker-compose.yml und Entrypoint-Skripte mit. Das ist ein starker Hinweis, dass die Maintainer zwei Betriebsmodi erwarten:

• eine normale lokale Entwickler-Installation,
• ein reproduzierbareres containerisiertes Setup für geteilte oder gehostete Läufe.

Für Evaluierungsarbeit beginne zuerst lokal. Für Team-Rollouts oder wiederholbare Demos wechsle zu Docker, nachdem die grundlegende Agent-Schleife funktioniert.

5. Praktischer Rat für den ersten Start

Eine gute Reihenfolge für den ersten Start ist:

1. mit uv installieren,
2. nanobot --version bestätigen,
3. die Übersichts- und Architekturseiten einmal lesen,
4. erst dann Anbieter, Tools oder UI-Flächen hinzufügen.

Diese Reihenfolge hält „Installationsprobleme“ getrennt von „Problemen mit dem Agent-Verhalten“.