ouroboros-ai

library0.36.0pypypiunverified

Ouroboros is a specification-first workflow engine for AI coding agents, integrating with Claude Code and Codex CLI. It allows you to define reusable workflows using YAML specs and execute them via agents. Current version is 0.36.0, with a fast release cadence and breaking changes between minor versions.

llm-agents workflow ai-ml devops

pip install ouroboros-ai

package ↗homepage ↗

INSTALL

IMPORT

SIG · OUROBOROS-AI

ouroboros-ai

llm-agentspythonv0.36.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WorkflowEngine

✓ from ouroboros import WorkflowEngine

✗ from ouroboros import WorkflowEngine

Load a YAML workflow specification and execute it using the engine.

import os from ouroboros import WorkflowEngine, load_workflow workflow = load_workflow("my_workflow.yaml") engine = WorkflowEngine(api_key=os.environ.get('ANTHROPIC_API_KEY', 'test-key')) result = engine.run(workflow) print(result)

ouroboros --version

Debug

Known issues

breakingIn version 0.35.0, the 'run' method signature changed: it now requires 'workflow' as keyword argument, not positional.

fix

Update calls from `engine.run(workflow)` to `engine.run(workflow=workflow)` or just `engine.run(workflow)` if using keyword (still works in 0.35+). Actually the signature changed: previous positional args may now be keyword-only. Check migration guide.

affects: <0.35.0

breakingWorkflow spec format changed from 'tasks' to 'steps' in version 0.30.0. Old YAML files will fail to load.

fix

Rename 'tasks' top-level key to 'steps' in your YAML files, and adjust per-step field names.

affects: <0.30.0

gotchaThe package name on PyPI is 'ouroboros-ai' (with hyphen), but the importable module is 'ouroboros' (no hyphen). Common mistake: try to import from 'ouroboros_ai'.

fix

Use `import ouroboros` or `from ouroboros import ...`.

affects: all

Upgrade

Version history

0.36.0latest on PyPI · released May 7, 2026

Audit

Dependencies

pydanticrequiredUsed for data validation and settings management

pyyamlrequiredRequired for reading YAML workflow specifications

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/ouroboros-ai/ ↗

homepagehttps://ouroboros-ai.dev ↗