Packagepip install millrace-ai
FrameworkGoverned AI workflow loops
ControlSpecification, graph, contracts, transition
EvidenceInspectable runs and receipts
Open-source loop engineering framework

Millrace turns complex workflows into governed AI loops.

Millrace is an open-source loop engineering framework for governed AI workflows.

Define the workflow once. Millrace compiles it into a deterministic, multi-step governed loop agents can run, inspect, recover, and repeat.

Read the evidence See workflows Open architecture
pip install millrace-ai
InputWorkflow specification
AuthorityCompiled graph
ExecutionContracted stages
OutputEvidence trail
Evidence 01

A small receipt trail, not a sales pitch.

The evidence repository records real governed loops, including the Rust maintenance pipeline, with receipts an operator can inspect.

Read the evidence Open evidence repo
Architecture 02

Specifications compile into governed loops.

Generic Millrace loop

The preview shows the framework boundary: specification in, governed transition out, evidence retained.

Open architecture
01 Specify the workflow

Define stages, allowed transitions, completion rules, and recovery behavior once.

02 Millrace owns the loop

The runtime compiles the graph, enforces stage contracts, and waits for a valid terminal status marker.

03 Agents run inside stages

The agent performs the work, then reports done, blocked, failed, or needs review in the expected form.

04 Transition with receipts

Millrace advances, recovers, completes, or preserves the blocked state with inspectable evidence.

Graph authority
Stage contracts
Terminal markers
Deterministic transitions

The agent performs the stage. The runtime decides the valid transition from compiled configuration.

Explore architecture See workflows Read evidence
Go deeper 03

Follow the framework, evidence, and product path.

EvidenceReceipts for governed loops, shipped software maintenance, and public limitations. WorkflowsLAD and other specified workflow families governed by Millrace loops. ArchitectureGraph authority, stage contracts, terminal markers, transitions, and recovery. Millrace OSThe work-in-progress control plane for queues, runs, evidence, and daemon readiness. RoadmapWhat is shipped, in progress, planned, and intentionally unplanned. BlogRelease notes, architecture writing, and field notes from the framework. CodebaseOpen-source package, runtime code, and implementation history.
Follow the framework 04

Subscribe. No catch.

Get notified when new framework updates are released.

No spam. Just new framework updates.