---
title: "StatePilot · Deterministische State-Machine-Wächter für"
description: "Deterministische State-Machine-Wächter für KI-Agent-Workflows. Erzwingt erlaubte Tool-Reihenfolge, Übergänge, Loop-Limits und Kosten-Budgets zur Laufzeit."
canonical: "https://matthiasmeyer.tech/de/repos/statepilot"
language: "de"
last_updated: "2026-08-01"
markdown_versions: ["https://matthiasmeyer.tech/repos/statepilot.md", "https://matthiasmeyer.tech/de/repos/statepilot.md", "https://matthiasmeyer.tech/es/repos/statepilot.md"]
image: "https://matthiasmeyer.tech/api/og/repo/statepilot?lang=de"
publisher: "Matthias Meyer, https://matthiasmeyer.tech (llms.txt: https://matthiasmeyer.tech/llms.txt)"
---

agents stable Python

# 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.

[Auf GitHub ansehen →](https://github.com/studiomeyer-io/statepilot)[PyPI](https://pypi.org/project/statepilot/)

## 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
```

## Verwandte Repos

- Agent Fleet

    → sichert den Tool-Fluss von

    →

    https://matthiasmeyer.tech/de/repos/agent-fleet

- Darwin LangGraph

    → Laufzeit-Guardrails für

    →

    https://matthiasmeyer.tech/de/repos/darwin-langgraph

## Sitemap

Alle Seiten dieser Website als Markdown: [Sitemap](https://matthiasmeyer.tech/sitemap.md). Kuratierter Einstieg: [llms.txt](https://matthiasmeyer.tech/llms.txt).