agent-actions

Declarative LLM orchestration. Define workflows in YAML — each action gets its own model, context window, schema, and pre-check gate. The framework handles DAG resolution, parallel execution, batch processing, and output validation.

[!WARNING] Experimental — Under active development. Expect breaking changes. Open an issue with feedback.

Agent Actions lifecycle: Define → Validate → Execute

actions:
  - name: extract_features
    intent: "Extract key product features from listing"
    model_vendor: anthropic              # Each action picks its own model
    model_name: claude-sonnet-4-20250514

  - name: generate_description
    dependencies: [extract_features]
    model_vendor: openai                 # Mix vendors in one pipeline
    model_name: gpt-4o-mini
    context_scope:
      observe:
        - extract_features.features      # See only what it needs
      drop:
        - source.raw_html                # Don't waste tokens on noise

Install

pip install agent-actions

Quick start

agac init my_project && cd my_project                # scaffold a project
agac init example contract_reviewer my_project       # or start from an example
agac run -a my_workflow                              # execute

Why not just write Python?

You will, until you have 15 steps, 3 models, batch retry, and a teammate asks what your pipeline does.

Capability	Agent Actions	Python script	n8n / Make
Per-step model selection	YAML field	Manual wiring	Per-node config
Context isolation per step	`observe` / `drop`	You build it	Not available
Pre-check guards (skip before LLM call)	`guard:`	If-statements	Post-hoc branching
Parallel consensus (3 voters + merge)	2 lines of YAML	Custom code	Many nodes + JS
Schema validation + auto-reprompt	Built in	DIY	Not available
Batch processing (1000s of records)	Built in	For-loops	Loop nodes
The YAML is the documentation	Yes	No	Visual graph

Examples

Example	Pattern	Key Features
Review Analyzer	Parallel consensus	3 independent scorers, vote aggregation, guard on quality threshold
Contract Reviewer	Map-reduce	Split clauses, analyze each, aggregate risk summary
Product Listing Enrichment	Tool + LLM hybrid	LLM generates copy, tool fetches pricing, LLM optimizes
Book Catalog Enrichment	Multi-step enrichment	BISAC classification, marketing copy, SEO metadata, reading level
Incident Triage	Parallel consensus	Severity classification, impact assessment, team assignment, response plan
Support Resolution	Non-JSON pipeline	Classify, route, and draft responses using `output_field` — works with any model including local Ollama

Providers

Provider	Batch	Provider	Batch
OpenAI	Yes	Groq	Yes
Anthropic	Yes	Cohere	Online only
Google Gemini	Yes	Ollama (local)	Yes

Switch providers per-action by changing model_vendor.

Key capabilities

Pre-flight validation — schemas, dependencies, templates, and credentials checked before any LLM call
Batch processing — route thousands of records through provider batch APIs
User-defined functions — Python tools for pre/post-processing and custom logic
Reprompting — auto-retry when LLM output doesn't match schema
Observability — per-action timing, token counts, and structured event logs
Interactive docs — agac docs builds and serves a visual workflow dashboard

Documentation

Full docs — guides, tutorials, reference
Configuration — YAML schema reference
CLI — all commands and options

Contributing

git clone https://github.com/Muizzkolapo/agent-actions.git && cd agent-actions
uv sync
pytest

See CONTRIBUTING.md. Report bugs via Issues.

License

Apache License 2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_actions-0.2.7.tar.gz (8.0 MB view details)

Uploaded Jul 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

agent_actions-0.2.7-py3-none-any.whl (5.9 MB view details)

Uploaded Jul 18, 2026 Python 3

File details

Details for the file agent_actions-0.2.7.tar.gz.

File metadata

Download URL: agent_actions-0.2.7.tar.gz
Upload date: Jul 18, 2026
Size: 8.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agent_actions-0.2.7.tar.gz
Algorithm	Hash digest
SHA256	`fb7236e6ba96614ddfbef1373eb00246d6a3bb0551766af70dc8d3e41a531009`
MD5	`dedc6970d98b47cf592e234b94468bbc`
BLAKE2b-256	`1cb11d384064c7d6476190a292c02a5f4ae60e0aecd8d278f3e2aafffe42887c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_actions-0.2.7.tar.gz:

Publisher: publish.yml on Muizzkolapo/agent-actions

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agent_actions-0.2.7.tar.gz
- Subject digest: fb7236e6ba96614ddfbef1373eb00246d6a3bb0551766af70dc8d3e41a531009
- Sigstore transparency entry: 2194881046
- Sigstore integration time: Jul 18, 2026
Source repository:
- Permalink: Muizzkolapo/agent-actions@701d64c7766de250af3bb7dd453af9ad6a708e3b
- Branch / Tag: refs/tags/v0.2.7
- Owner: https://github.com/Muizzkolapo
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@701d64c7766de250af3bb7dd453af9ad6a708e3b
- Trigger Event: release