---
title: "StatePilot · Guardas de máquina de estados deterministas"
description: "Guardas de máquina de estados deterministas para flujos de agentes IA. Aplica el orden de tools permitido, las transiciones, los límites de bucle y los"
canonical: "https://matthiasmeyer.tech/es/repos/statepilot"
language: "es"
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=es"
publisher: "Matthias Meyer, https://matthiasmeyer.tech (llms.txt: https://matthiasmeyer.tech/llms.txt)"
---

agents stable Python

# StatePilot

Guardas de máquina de estados deterministas para flujos de agentes IA

Aplica el orden de tools permitido, las transiciones, los límites de bucle y los presupuestos de coste en runtime. Fail-closed, para que un agente no pueda salirse de su máquina de estados declarada. Núcleo sin dependencias, compatible con LangGraph. 74 tests, MIT, Python.

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

## Qué problema resuelve

Un tema recurrente en las herramientas para agentes es envolver un modelo no determinista en código determinista, y la razón es simple: pedirle a un agente que llame solo a estas herramientas en este orden es una petición, no una regla. Aguanta hasta que deja de aguantar. statepilot convierte esa petición en una máquina de estados que el runtime hace cumplir.

## Cómo funciona

Tú defines la máquina, y en tiempo de ejecución decide qué herramientas puede llamar el agente y en qué orden. Alrededor están los guardianes para los fallos que de verdad se ven: detección de bucles para el agente que reintenta el mismo paso una y otra vez, un presupuesto de coste y un tope duro al número de pasos. Lo que la máquina no permite lanza un error en vez de seguir en silencio. El núcleo no tiene dependencias en ejecución, está completamente tipado y necesita Python 3.10 o superior.

## Cuándo usarlo

Encaja con un flujo cuyos pasos puedes nombrar de verdad: una recogida de datos que debe ocurrir antes de una consulta, un pago que no puede ejecutarse dos veces, un escalado que solo se dispara tras una comprobación. Ahí una máquina de estados es una descripción del trabajo y no una jaula a su alrededor.

## Cuándo no usarlo

El trabajo abierto no encaja. Si no puedes dibujar los estados de antemano, gastarás más tiempo ensanchando la máquina del que ahorras teniéndola, y cada ensanchamiento es un agujero. La exploración, la investigación y todo aquello donde el paso siguiente depende de lo que encontró el anterior quedan fuera.

Stars

★ 0

installs

↓ 20

Clones (14d)

⊟ 12

Lenguaje

Python

Actualizado

2026-08-01

## Instalación

```
pip install statepilot
```

## Repos relacionados

- Agent Fleet

    → protege el flujo de tools de

    →

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

- Darwin LangGraph

    → guardrails de runtime para

    →

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

## Sitemap

Todas las páginas de este sitio en Markdown: [sitemap](https://matthiasmeyer.tech/sitemap.md). Punto de entrada: [llms.txt](https://matthiasmeyer.tech/llms.txt).