Zum Hauptinhalt springen

Nanobot Architektur und Laufzeit

1. Die Gestalt des Workspace​

Das Repo-Layout ist einer der schnellsten Wege, Nanobot zu verstehen:

BereichWarum er wichtig ist
nanobot/Haupt-Python-Paket und Agent-Laufzeit
docs/Architektur- und Entwicklungsanleitung
scripts/Installations- und Projekt-Bootstrap-Helfer
Dockerfile und docker-compose.ymlContainerisierte Laufzeit und Deployment-Pfad
Bridge-bezogener CodeExterne Integrationsfläche

Das Projekt ist klein genug, dass du es noch als Ganzes lesen kannst, was einer seiner Vorteile ist.

2. Das mentale Laufzeitmodell​

Auf hoher Ebene folgt Nanobot einer vertrauten Agent-Gestalt:

  1. Benutzer- oder Systemeingabe trifft ein,
  2. die Laufzeit bereitet Kontext vor,
  3. das Modell entscheidet, ob es direkt antwortet oder ein Tool nutzt,
  4. Tool-Aufrufe werden ausgefĂĽhrt,
  5. Ergebnisse kehren zur Modellrunde zurĂĽck,
  6. die finale Ausgabe wird über die aktive Fläche zurückgegeben.

Das klingt nach Standard, aber das Nützliche ist, dass Nanobot diese Schleife relativ zugänglich hält für Entwickler, die sie verstehen oder anpassen wollen.

3. Warum sich die Architektur leichtgewichtig anfühlt​

Nanobot versucht nicht, eine riesige Enterprise-Control-Plane zu sein. Seine Architektur ähnelt eher:

einer Agent-Laufzeit mit optionalen unterstützenden Flächen

als:

einem Fleet-Management-System fĂĽr tausende langlaufende Agenten

Das ändert, wie du den Code lesen solltest. Du suchst hauptsächlich nach Laufzeitfluss, Tool-Verdrahtung und Integrationsgrenzen, nicht nach verteilten Scheduling-Schichten.

4. Die UI- und Bridge-Flächen​

Das Vorhandensein einer Web-UI und Bridge-bezogenen Codes deutet auf eine nützliche Aufteilung der Zuständigkeiten hin:

  • das Kernpaket besitzt das Agent-Verhalten,
  • die UI-Schicht besitzt Interaktion und Sichtbarkeit,
  • die Bridge-Schicht besitzt externe Ăśbergabe- oder Integrationslogik.

Das ist eine saubere Trennung für ein Projekt dieser Größe, weil es dir erlaubt, eine Fläche zu ändern, ohne die gesamte Laufzeit neu zu schreiben.

5. Was man im Code zuerst lesen sollte​

Wenn du die Implementierung studieren willst, beginne hier:

  1. die Architektur-Doc,
  2. das Haupt-Paket nanobot/,
  3. Installations- und Entrypoint-Skripte,
  4. Docker-bezogene Dateien,
  5. die Entwicklungs-Docs, sobald du bereit bist beizutragen.