Orchestrator-Core

Discord

Production ready Orchestration Framework to manage product lifecycle and workflows. Easy to use, built on top of FastAPI and Pydantic

Documentation

The documentation can be found at workfloworchestrator.org.

Installation (quick start)

Simplified steps to install and use the orchestrator-core. For more details, read the Getting started documentation.

Step 1 - Install the package

Create a virtualenv and install the orchestrator-core.

python -m venv .venv
source .venv/bin/activate
pip install orchestrator-core

Step 2 - Setup the database

Create a postgres database:

createuser -sP nwa
createdb orchestrator-core -O nwa  # set password to 'nwa'

Configure the database URI in your local environment:

export DATABASE_URI=postgresql+psycopg://nwa:nwa@localhost:5432/orchestrator-core

Step 3 - Create main.py and wsgi.py

Create a main.py file for running the CLI.

from orchestrator.core.cli.main import app as core_cli

if __name__ == "__main__":
    core_cli()

Create a wsgi.py file for running the web server.

from orchestrator.core import OrchestratorCore
from orchestrator.core.settings import AppSettings

app = OrchestratorCore(base_settings=AppSettings())
app.register_graphql()

Step 4 - Run the database migrations

Initialize the migration environment and database tables.

python main.py db init
python main.py db upgrade heads

Step 5 - Run the app

export OAUTH2_ACTIVE=False
uvicorn --reload --host 127.0.0.1 --port 8080 wsgi:app

Visit the ReDoc or OpenAPI page to view and interact with the API.

Contributing

We use uv to manage dependencies. Unit tests need no services; integration tests use testcontainers to spin up Postgres + Redis on demand (Docker required).

To get started, follow these steps:

# on your local machine
git clone https://github.com/workfloworchestrator/orchestrator-core
cd orchestrator-core
just pytest                              # Run unit tests
just pytest test/integration_tests       # Run integration tests (testcontainers)
just pytest -vx                          # Stop at first failed test
just pytest --last-failed                # re-run only failed tests

For more details please read the development docs.

Download files

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

Source Distribution

orchestrator_core-5.1.3.tar.gz (381.2 kB view details)

Uploaded Jul 16, 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.

orchestrator_core-5.1.3-py3-none-any.whl (676.0 kB view details)

Uploaded Jul 16, 2026 Python 3

File details

Details for the file orchestrator_core-5.1.3.tar.gz.

File metadata

Download URL: orchestrator_core-5.1.3.tar.gz
Upload date: Jul 16, 2026
Size: 381.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for orchestrator_core-5.1.3.tar.gz
Algorithm	Hash digest
SHA256	`30f5da23ad8696e848a1a831accb9e05416a43f0eab30551c767d613780b9252`
MD5	`5668548931ba0014cf1fb1ed8aa313d9`
BLAKE2b-256	`0d8b24d7db61cd00eb81eb08b12cab2598059cb97915027b7624e9d433e03d4b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for orchestrator_core-5.1.3.tar.gz:

Publisher: publish-package.yml on workfloworchestrator/orchestrator-core

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: orchestrator_core-5.1.3.tar.gz
- Subject digest: 30f5da23ad8696e848a1a831accb9e05416a43f0eab30551c767d613780b9252
- Sigstore transparency entry: 2182644906
- Sigstore integration time: Jul 16, 2026
Source repository:
- Permalink: workfloworchestrator/orchestrator-core@4e54319f9c967a999837dd361db8a60da6e9f53a
- Branch / Tag: refs/tags/5.1.3
- Owner: https://github.com/workfloworchestrator
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-package.yml@4e54319f9c967a999837dd361db8a60da6e9f53a
- Trigger Event: release