orcheo 0.4.0

Add your description here

Orcheo

Orcheo is a tool for creating and running workflows.

Repository layout

• src/orcheo/ – core orchestration engine and FastAPI implementation
• apps/backend/ – deployment wrapper exposing the FastAPI ASGI app
• packages/sdk/ – lightweight Python SDK for composing workflow requests
• apps/canvas/ – React + Vite scaffold for the visual workflow designer

Quick start

The project ships with everything needed to spin up the FastAPI runtime on SQLite for local development.

1. Install dependencies

   uv sync --all-groups
   

2. Seed environment variables

   uv run orcheo-seed-env
   

   Pass -- --force to overwrite an existing .env file.

3. Run the API server

   uv run orcheo-dev-server
   

4. Verify the setup

   uv run orcheo-test
   

Opening the repository inside VS Code automatically offers to start the included dev container with uv and Node.js preinstalled. The new quickstart flows in examples/quickstart/ demonstrate the visual designer and SDK user journeys.

See docs/deployment.md for Docker Compose and managed PostgreSQL deployment recipes.

Releasing packages

Follow docs/releasing.md for the step-by-step guide to version, tag, and publish the orcheo, orcheo-backend, and orcheo-sdk packages independently via the automated CI workflows.