{"repo":"memgrafter/flatmachines","free":true,"listed":false,"github":"https://github.com/memgrafter/flatmachines","clone":"git clone https://github.com/memgrafter/flatmachines.git","description":"Orchestrate agents with a peer network of state machines. Supports checkpoint/restore, persistence, and more. BYO cli, or agent, or use flatagents with API. Batteries included.","language":"Python","stars":37,"topics":["agents","ai","ai-agents","llms","orchestration","specification","state-machines"],"license":"Apache-2.0","category":"ai-agents","readme_excerpt":"FlatMachines Orchestrate agents with a peer network of state machines. Supports checkpoint/restore, persistence, and more. Batteries included. BYO cli, or agent, or use flatagents with API. Warning: this repo is a product of its times. Caveat emptor. Prefer the Python SDK for now, not yet JS or Rust. Use ./sdk/examples/ to get started. For LLM/machine readers: see AGENTS.md for a compact reference. TL;DR You write YAML that describes states, transitions, and agents. The runtime handles retries, parallelism, checkpointing, error recovery, and distributed workers. Your Python code stays small. The runtime handles retries, error routing, and state. You change behavior by editing YAML, not refactoring Python. Quick Start For a coding agent (tool calling repl) example, see Coding Machine CLI. The fastest path is to run the helloworld example: To start from scratch in your own project: We will use 3 config files for this demo: profiles.yml (model catalog), agent.yml (single LLM call), and machine.yml (orchestration). Start with a clear default profile, then let agents reference it by name: config/profiles.yml config/agent.yml config/machine.yml run.py Versioning All specs and SDKs use lockstep versioning . A single version number applies across the entire repository. Examples Runnable examples in ./sdk/examples : Example What it demonstrates --------- --------------------- helloworld Minimal loop — build a string char by char writer critic Feedback loop between two agents paralleli","default_branch":null,"files":null,"tree":[],"storefront":"/r/memgrafter","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/memgrafter/flatmachines/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}