FastAPI + Pydantic AI Agent Worker

Hermetic Python autonomous worker with Prompt Guard 2, SSRF egress filter, and LangGraph.

★ 289 GitHub stars

npx brevio init --blueprint=fastapi-agent-worker

Python 3.12FastAPIPydantic V2LangGraphPrompt Guard 2

Initial Roadmap & Feature Tasks (3)

TASK-001 · SSRF-Safe Egress ClientP0 · GUARDRAIL

Acceptance Criteria: Blocked loopback, cloud metadata, and link-local destinations.

TASK-002 · Prompt Guard 2 Scoring NodeP0 · GUARDRAIL

Acceptance Criteria: Shadow logs untrusted prompts and terminates malicious payloads.

TASK-003 · LangGraph State Machine with CheckpointingP1 · INFRA

Acceptance Criteria: Persistent task checkpoints with replay from named step.

CONSTITUTION.md

Immutable Floors

# Engineering Constitution — FastAPI Agent Worker

1. Zero Secrets in environment dumps or runtime logs.
2. Untrusted inputs must pass through Prompt Guard 2 scoring (< 0.85 threshold).
3. Outbound HTTP requests must route through SSRF validator (private CIDRs blocked).
4. Cyclomatic complexity per function must not exceed 10.
5. Zero in-function imports or broad exception suppression.

CLAUDE.md

Coding Guidance

# Assistant Guidelines — FastAPI Agent Worker

- All endpoint functions require explicit Pydantic response models.
- Handle external HTTP errors with classified retries (transient vs permanent).
- Provide pytest test suites with >= 85% branch coverage.

Ready to materialize this project?

Run the single-line init command to generate your workspace.

Initialize in Launchpad →