nanobot: ein selbst gehostetes persönliches KI-Agenten-Framework

Die selbst gehostete Agenten-Laufzeit

nanobot ist ein in Python geschriebenes Open-Source-Framework für persönliche KI-Agenten und wird im README als ultraleicht und selbst gehostet beschrieben. Es läuft in einer WebUI, im Terminal oder in Chat-Apps und kombiniert Tools, Langzeitspeicher, MCP-Integrationen, Modell-Routing, Multi-Agenten-Delegation, geplante Automatisierung und eine OpenAI-kompatible API in einem kleinen, lesbaren Kern. Die Repository-Metadaten listen Python als Hauptsprache, und das Projekt wird unter der MIT-Lizenz verteilt. Das README enthält keine Leistungsbenchmarks oder Sicherheitsauditergebnisse; diese sind durch die Quelle nicht belegt.

Installationsoptionen und Voraussetzungen

Das README dokumentiert vier Installationswege. Der Ein-Befehl-Installer für macOS und Linux verwendet curl, das PowerShell-Pendant für Windows verwendet irm. Beide installieren oder aktualisieren standardmäßig das Paket nanobot-ai von PyPI und starten dann auf einem neuen Desktop nanobot webui. Die Installation mit dem uv-Tool lautet uv tool install nanobot-ai, und eine pip-Installation verwendet python -m pip install nanobot-ai. Eine Quellinstallation erfordert bun oder npm sowie eine aktivierte virtuelle Umgebung. Python 3.11 oder neuer ist erforderlich. Das README erwähnt, dass pip unter macOS oder Linux möglicherweise externally-managed-environment meldet, und empfiehlt den Ein-Befehl-Installer, das uv-Tool, pipx oder eine virtuelle Umgebung. Die Befehle werden wörtlich aus dem README zitiert.

Erster Start und die drei Schnittstellen

Der empfohlene erste Befehl ist nanobot webui. Er erstellt bei Bedarf die Konfiguration und den Arbeitsbereich, aktiviert nach Bestätigung sicher den lokalen WebSocket-Kanal, startet das Gateway und öffnet http://127.0.0.1:8765. Eine frische Installation kann sich öffnen, bevor ein Modell konfiguriert ist, sodass die Einrichtung im Browser fortgesetzt wird. Die WebUI beim ersten Start bindet standardmäßig an localhost und ist nicht im LAN sichtbar. Zum Weiterlaufen nach dem Schließen des Terminals verwenden Sie nanobot webui --background. Der Gateway-Befehl nanobot gateway überspringt die WebUI-Einrichtung und führt das vollständige Gateway im aktuellen Terminal aus, während nanobot agent einen interaktiven Terminal-Chat öffnet. Eine Einmalform, nanobot agent -m "Hello!", ist ebenfalls dokumentiert.

Architektur und Agenten-Schleife

Das README erklärt, dass nanobot leicht bleibt, indem alles um eine kleine Agenten-Schleife zentriert wird: Nachrichten kommen von Chat-Apps herein, das LLM entscheidet, wann Tools benötigt werden, und Speicher oder Fähigkeiten werden nur als Kontext eingezogen, anstatt eine schwere Orchestrierungsschicht zu bilden. Das Framework enthält Tools wie Dateien, Shell, Websuche, Web-Fetch, MCP, Cron, Bildgenerierung und Subagenten. Sitzungsverlauf und Langzeitspeicher werden über eine Funktion namens Dream verarbeitet. Das README spezifiziert weder den zugrunde liegenden Speichermechanismus für den Speicher noch die Implementierungsdetails von Dream; diese Informationen sind in der Quelle nicht vorhanden.

WebUI-Paketierung und Bereitstellung

Die WebUI ist im veröffentlichten Wheel enthalten, sodass eine PyPI-Installation keinen separaten Frontend-Build erfordert. Für die Cloud-Bereitstellung bietet das Repository ein Render-Blueprint, das nach ANTHROPIC_API_KEY und einem privaten NANOBOT_WEB_TOKEN fragt; persistenter Speicher erfordert einen kostenpflichtigen Render-Dienst. Der selbst gehostete Pfad ist im Bereitstellungsleitfaden dokumentiert und umfasst Docker, Docker Compose, Linux-Dienste und macOS LaunchAgent. Hintergrundbetrieb wird ebenfalls mit nanobot gateway --background unterstützt. Das README spezifiziert keine Ressourcenanforderungen oder Skalierungsgrenzen für einen Bereitstellungsmodus.

Release, Updates und Beitrag

Das im README genannte neueste Release ist v0.3.0, genannt The Agency Release, das Inline-Subagenten, Modellwechsel pro Sitzung, geführte WebUI-Einrichtung und Live-Konfigurationsänderungen hinzufügt. Die im README aufgeführten letzten Updates decken Änderungen vom 2026-07-20 bis 2026-07-24 ab, darunter geführte Ersteinrichtung, Grok OAuth mit gehosteter X Search, parallele Suche und Codex-Schnellmodus. Das Projekt wird gemeinschaftlich gepflegt und wurde von Xubin Ren gestartet. Die Repository-Metadaten zeigen 46.645 Sterne und 8.252 Forks zum Zeitpunkt des Schnappschusses. Die MIT-Lizenz gewährt das Recht, Kopien zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, während die Software ohne Gewährleistung "wie sie ist" bereitgestellt wird.

Bei HKUDS/nanobot muss die praktische Einordnung an der veröffentlichten README bleiben. Der dokumentierte Stand nennt konkrete Dateien, Befehle oder Konfigurationswerte, die für einen Test wichtiger sind als allgemeine Produktversprechen. Diese Angaben beschreiben den vorgesehenen Weg, sie ersetzen keine Aussage über jede Plattform oder jede Betriebsumgebung. Für die Prüfung von nanobot sollte dieser Punkt mit einer kleinen, kontrollierten Eingabe nachvollzogen werden. Beobachten Sie die Ausgabe, Fehlermeldungen und erzeugten Dateien und halten Sie fest, welche Teile aus nanobot stammen und welche Abhängigkeiten von der lokalen Umgebung kommen.

Redaktionelles Fazit

nanobot wird als ein Agenten-Laufzeitsystem mit kleinem Kern beschrieben, das von PyPI oder aus dem Quellcode installiert werden kann, in WebUI, Terminal oder Chat-Apps läuft und mit Tools, Speicher und Automatisierung erweitert werden kann. Das README enthält keine Benchmarks, Sicherheitsaudits oder Details zum Produktionssupport; diese Fragen bleiben offen.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes