StatePilot
Deterministische State-Machine-Wächter für KI-Agent-Workflows
Erzwingt erlaubte Tool-Reihenfolge, Übergänge, Loop-Limits und Kosten-Budgets zur Laufzeit. Fail-closed, damit ein Agent seine deklarierte State-Machine nicht verlassen kann. Zero-Dependency-Kern, LangGraph-fähig. 74 Tests, MIT, Python.
Welches Problem es löst
Ein wiederkehrendes Thema im Agenten-Werkzeugbau ist, ein nicht deterministisches Modell in deterministischen Code zu hüllen, und der Grund ist einfach: einen Agenten zu bitten, nur diese Werkzeuge in dieser Reihenfolge zu rufen, ist eine Bitte, keine Regel. Sie hält, bis sie nicht mehr hält. statepilot macht aus der Bitte einen Zustandsautomaten, den die Laufzeit durchsetzt.
Wie es arbeitet
Du legst den Automaten fest, und zur Laufzeit entscheidet er, welche Werkzeuge der Agent aufrufen darf und in welcher Reihenfolge. Darum herum liegen die Wächter für die Fehlerbilder, die man tatsächlich sieht: Schleifenerkennung für den Agenten, der denselben Schritt immer wieder versucht, ein Kostenbudget und eine harte Obergrenze für die Zahl der Schritte. Was der Automat nicht erlaubt, wirft einen Fehler, statt still weiterzulaufen. Der Kern hat keine Laufzeit-Abhängigkeiten, ist durchgetypt und braucht Python 3.10 oder neuer.
Wann du es nimmst
Es passt zu einem Ablauf, dessen Schritte du wirklich benennen kannst: eine Aufnahme, die vor einer Abfrage passieren muss, eine Zahlung, die nicht zweimal laufen darf, eine Eskalation, die erst nach einer Prüfung greift. Dort ist ein Zustandsautomat eine Beschreibung der Arbeit und kein Käfig darum.
Wann du es nicht nimmst
Offene Arbeit passt nicht. Wenn du die Zustände nicht vorher zeichnen kannst, verbringst du mehr Zeit damit, den Automaten aufzuweiten, als du durch ihn sparst, und jede Aufweitung ist ein Loch. Erkundung, Recherche und alles, wo der nächste Schritt davon abhängt was der letzte gefunden hat, gehören nicht hinein.
Stars
★ 0
installs
↓ 20
Clones (14d)
⊟ 12
Sprache
Python
Aktualisiert
2026-08-01
Installation
pip install statepilot