Metadata-Version: 2.4
Name: godel-py
Version: 3.13.2
Summary: Deterministic orchestrator for AI agent workflows
Project-URL: Homepage, https://github.com/atscub/godel-py
Project-URL: Repository, https://github.com/atscub/godel-py
Project-URL: Documentation, https://github.com/atscub/godel-py/tree/main/docs
Project-URL: Spec, https://github.com/atscub/godel-lang
Author-email: Abraham Toledo <godel@abrahamtoledo.dev>
License: BSL-1.1
License-File: LICENSE
Keywords: agents,ai,deterministic,orchestration,replay,workflow
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.10
Requires-Dist: click
Requires-Dist: pydantic>=2
Requires-Dist: python-ulid
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: python-semantic-release; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Requires-Dist: syrupy>=4.0; extra == 'dev'
Provides-Extra: watch
Requires-Dist: rich<15,>=13.0; extra == 'watch'
Description-Content-Type: text/markdown

# godel-py

Python implementation of **Godel** — a deterministic orchestrator for AI agent workflows. Workflows are plain Python decorated with `@workflow` / `@step`, with automatic event logging, pause/resume, and rewind.

The language spec and design docs live in the companion repo: [atscub/godel-lang](https://github.com/atscub/godel-lang).

## Install

```bash
pip install godel-py
```

## Quick start

```python
from godel import workflow, step, run

@step
def build():
    return run(["npm", "run", "build"])

@workflow
def ci():
    build()
```

```bash
godel run ci.py
```

See [docs/why-godel.md](docs/why-godel.md) for the thesis, `.agents/CLI.md` for the full CLI reference, and `docs/` for user guides, API reference, and examples.

## Development

```bash
pip install -e ".[dev]"
pytest
```

Requires Python 3.10+.

## Release process

Merges to `main` trigger `.github/workflows/publish.yml`, which runs tests and then `python-semantic-release`. Conventional commits (`feat:`, `fix:`, `feat!:`) drive version bumps, tag creation, changelog generation, and wheel+sdist upload to a GitHub Release.

## License

Business Source License 1.1 — see [LICENSE](LICENSE) for details. You are free to use Godel as a library in your own applications, including commercially. The only restriction is offering Godel itself as a competing hosted orchestration service. After six years, each version converts to Apache 2.0.
