orcheo 0.9.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, and examples/ingest_langgraph.py shows how to push a Python LangGraph script directly to the backend importer, execute it, and stream live updates.

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

CLI

Orcheo ships with a LangGraph-friendly CLI for node discovery, workflow inspection, credential management, and reference code generation. Install the workspace dependencies and invoke the CLI via uv:

uv run orcheo --help

Example commands:

• uv run orcheo node list – enumerate registered nodes and their metadata
• uv run orcheo workflow show <workflow-id> – inspect workflows, graph versions, and recent runs
• uv run orcheo credential create <name> --provider <provider> --secret <value> – manage vault credentials
• uv run orcheo code scaffold <workflow-id> – generate Python snippets that trigger workflows via the SDK

Pass --offline to reuse cached metadata when disconnected. See docs/cli_tool_design.md for roadmap details and future MCP server integration plans.

Frontend experience plan

The path to a production-quality canvas is captured in docs/frontend_plan.md, outlining research, design system development, architectural refactors, and QA milestones for the React application. Start there when kicking off frontend workstreams so design and engineering stay aligned.

Workflow repository configuration

The FastAPI backend now supports pluggable workflow repositories so local development can persist state without depending on Postgres. By default the app uses a SQLite database located at ~/.orcheo/workflows.sqlite. Adjust the following environment variables to switch behaviour:

• ORCHEO_REPOSITORY_BACKEND: accepts sqlite (default) or inmemory for ephemeral testing.
• ORCHEO_REPOSITORY_SQLITE_PATH: override the SQLite file path when using the SQLite backend.

Refer to .env.example for sample values and to docs/deployment.md for deployment-specific guidance.

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.