AI Workflow Framework — orchestrate AI agents through deterministic, auditable YAML workflows.
🌐 Website: awf-project.ai | 💬 Community: r/awf_project | 📦 Core CLI: awf-project/cli
AWF (AI Workflow Framework) lets you define complex AI-assisted automations as state-machine YAML workflows. Instead of stitching together ad-hoc scripts, you declare steps, transitions, and agents — then let the CLI execute them with full observability, retry logic, audit trails, and safety controls.
Supported AI providers include Claude, Gemini, Codex, GitHub Copilot, Mistral Vibe, OpenCode, and any OpenAI-compatible API (Ollama, vLLM, Groq, …).
# .awf/workflows/review.yaml
name: code-review
states:
initial: analyze
analyze:
type: agent
provider: claude
prompt: "Review this file for bugs: {{.inputs.file}}"
on_success: done
done:
type: terminal
status: successawf run code-review --input file=main.go| Repository | Language | Description |
|---|---|---|
| cli | Go | Main CLI — YAML workflow execution engine, state machines, agent orchestration, TUI, REST API, MCP proxy, plugin system, workflow packs |
| awf-project.github.io | HTML | Source for the awf-project.ai website |
| Repository | Language | Description |
|---|---|---|
| awf-marketplace | Shell | Plugin marketplace for the AWF CLI, compatible with Claude Code and Codex |
| awf-plugin-time | Go | AWF plugin — injects system date/time into workflow steps |
| awf-workflow-hello | Makefile | Example AWF workflow pack to get started |
| awf-workflow-speckit | Shell | Speckit integration for AWF |
| Repository | Language | Description |
|---|---|---|
| ztick | Zig | Push-driven, time-based job scheduler — schedule AWF workflows via TCP/HTTP |
| zpm | Zig | High-performance MCP server bridging LLMs with a Prolog inference engine for deterministic reasoning |
| tower | Rust | Experimental — VFS indexing engine driven by AI via the MCP protocol |
| Repository | Language | Description |
|---|---|---|
| devcontainer-features | Shell | Dev Container features for AWF-based projects |
| devcontAIner | Shell | AI-augmented Dev Container base image |
| setup-awf | Shell | GitHub Actions step to install and configure AWF |
# Install the AWF CLI
curl -fsSL https://raw.githubusercontent.com/awf-project/cli/main/scripts/install.sh | sh
# Initialise AWF in your project
awf init
# Run your first workflow
awf run example- 💬 Reddit: r/awf_project — questions, showcases, discussion
- 🐛 Issues: open an issue in the relevant repository
- ❤️ Sponsor: github.com/sponsors/pocky
All AWF repositories are released under the EUPL-1.2 (European Union Public Licence).
Individuals and companies are free to use AWF under its open-source terms. A commercial licence is available — see the cli README for details.
Maintained by Alexandre Balmes with ❤️