Show HN: Flatagents: State machine orchestration with stateless LLM agents

[beacon294]

This is a declarative orchestration framework for stateless short-lived LLM agents.

Agents are orchestrated by hierarchical state machines (HSMs).

The HSMs and agents are defined in YAML, with hooks and webhooks for additional functionality.

* FlatAgent: A single LLM call: model + prompts + output schema.

* FlatMachine: A state machine that orchestrates multiple agents, actions, and state machines.

Examples: - https://github.com/memgrafter/flatagents/tree/main/sdk/pytho... - https://github.com/memgrafter/research-crawler-flatagents - https://github.com/memgrafter/claude-skills-flatagents

[beacon294]

These are called flat because they are defined in flat files.

Apparently researchers call non-hierarchical state machines "flat machines" / "flat agents". Oh well!

I think editing post content locks after some time or edit count.

Well-formatted examples:

* https://github.com/memgrafter/flatagents/tree/main/sdk/pytho...

* https://github.com/memgrafter/research-crawler-flatagents

* https://github.com/memgrafter/claude-skills-flatagents