This release is a pre-release and may not be stable for production use.
Orcheo
Orcheo is a workflow orchestration platform designed for vibe coding — AI coding agents like Claude Code can start services, build workflows, and deploy them for you automatically. Read the full documentation for guides, API reference, and examples.
Note: This project is currently in Beta. Expect breaking changes as we iterate rapidly towards 1.0.
SIGIR Reviewers: See the Conversational Search Examples for step-by-step demos from basic RAG to production-ready search.
Why Orcheo?
- Vibe-coding-first: Already using Claude Code, Codex CLI, or Cursor? You don't need to learn Orcheo. Install the agent skill and let your AI agent handle setup, workflow creation, and deployment.
- Python-native: Workflows are Python code powered by LangGraph — no proprietary DSL to learn.
- CLI-first: Run headless in production; the UI is optional.
Quick Start
Use the installation path that matches your setup:
Prerequisite: Docker Desktop/Engine must be installed to run the stack (
orcheo install --start-stack).
macOS / Linux
bash <(curl -fsSL https://ai-colleagues.com/install.sh)
Windows PowerShell
irm https://ai-colleagues.com/install.ps1 | iex
SDK
uv tool install -U orcheo-sdk
orcheo install
macOS/Linux (non-interactive)
curl -fsSL https://ai-colleagues.com/install.sh | bash -s -- --yes --start-stack
Upgrade
orcheo install upgrade --yes
orcheo install syncs Docker stack assets into ~/.orcheo/stack (or
ORCHEO_STACK_DIR), updates .env with setup-selected values, and can start the
stack with Docker Compose. Setup will prompt for
VITE_ORCHEO_CHATKIT_DOMAIN_KEY; you can skip it and continue, but ChatKit UI
features will stay disabled until you set a valid key.
The fastest way to get started with workflow building is still the Agent Skill approach.
Note: Most AI coding agents (Claude Code, Codex CLI, Cursor) require a paid subscription. Free alternatives may exist but have not been tested with Orcheo.
1. Install the Orcheo Agent Skill
Add the Orcheo agent skill to your AI coding agent (Claude Code, Cursor, etc.) by following the installation instructions in the repo.
2. Let Your Agent Do the Work
Once installed, simply ask your agent to:
- Set up Orcheo: "Set up Orcheo for local development"
- Create workflows: "Create a workflow that monitors RSS feeds and sends Slack notifications"
- Deploy workflows: "Deploy and schedule my workflow to run every hour"
Your AI agent will automatically:
- Install dependencies
- Start the backend server
- Create and configure workflows
- Handle authentication and deployment
That's it! Your agent handles the complexity while you focus on describing what you want your workflows to do.
Guides
- Manual Setup Guide — Installation, CLI reference, authentication, and Studio setup
- Conversational Search Examples — Step-by-step demos from basic RAG to production-ready search
# Conversational search demos now live in the colleague-candidates repo:
git clone https://github.com/AI-Colleagues/colleague-candidates
orcheo credential create openai_api_key --secret sk-your-key
# Demo 2 (Basic RAG) requires no external services:
orcheo workflow upload colleague-candidates/colleagues/conversational_search_demo_2/workflow.py \
--config-file colleague-candidates/colleagues/conversational_search_demo_2/config.json \
--name "Basic RAG"
Provider-aware chat models use provider-specific credential names in the active
vault by default. For example, openai:gpt-4.1 looks for openai_api_key,
while deepseek:deepseek-chat looks for deepseek_api_key.
Reference
- SDK Reference — Python SDK for programmatic workflow execution
- Environment Variables — Complete configuration reference
For Developers
- Developer Guide — Repository layout, development environment, and custom nodes
- Deployment Guide — Docker Compose and PostgreSQL deployment recipes
- Custom Nodes and Tools — Extend Orcheo with your own integrations
Contributing
We welcome contributions from the community:
- Share your extensions: Custom nodes, agent tools, and workflows that extend Orcheo's capabilities. See the Custom Nodes and Tools guide for how to create and load custom extensions.
- How to contribute: Open an issue, submit a pull request, or start a discussion. You can also publish and share your extensions independently for others to install.
Citation
If you use Orcheo in your research, please cite it as:
@inproceedings{jiang2026orcheo,
author = {Jiang, Shaojie and Vakulenko, Svitlana and de Rijke, Maarten},
title = {Orcheo: A Modular Full-Stack Platform for Conversational Search},
booktitle = {Proceedings of the 49th International ACM SIGIR Conference on Research and Development in Information Retrieval},
series = {SIGIR '26},
year = {2026},
publisher = {ACM},
address = {Melbourne, VIC, Australia},
doi = {10.1145/3805712.3808613}
}
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file orcheo-0.45.0a2.tar.gz.
File metadata
- Download URL: orcheo-0.45.0a2.tar.gz
- Upload date:
- Size: 4.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fd01c9b9ee5340a5151fe4488e1d1a001a9cafc80125681d855374ac42587792
|
|
| MD5 |
2371f471e647e52037a911006bc8c52e
|
|
| BLAKE2b-256 |
faecec123ddcc37ae9989b3aeb0b1d4d040b0fd8b0195d0729aff38ba1d603f8
|
Provenance
The following attestation bundles were made for orcheo-0.45.0a2.tar.gz:
Publisher:
ci.yml on AI-Colleagues/orcheo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
orcheo-0.45.0a2.tar.gz -
Subject digest:
fd01c9b9ee5340a5151fe4488e1d1a001a9cafc80125681d855374ac42587792 - Sigstore transparency entry: 2267193760
- Sigstore integration time:
-
Permalink:
AI-Colleagues/orcheo@52408f462658c20c2f632cd45c0a018c4edd90e6 -
Branch / Tag:
refs/tags/core-v0.45.0a2 - Owner: https://github.com/AI-Colleagues
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@52408f462658c20c2f632cd45c0a018c4edd90e6 -
Trigger Event:
push
-
Statement type:
File details
Details for the file orcheo-0.45.0a2-py3-none-any.whl.
File metadata
- Download URL: orcheo-0.45.0a2-py3-none-any.whl
- Upload date:
- Size: 568.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a8f78e18bb11074d5e9734d1d3cca4b7b97a75820a0502178494172283539d94
|
|
| MD5 |
eea780802d1e198cb6981fad2af206a9
|
|
| BLAKE2b-256 |
7526a79f7aae32a728a5708a2c44a62306745db6a8ed18fd0ba333805b877df0
|
Provenance
The following attestation bundles were made for orcheo-0.45.0a2-py3-none-any.whl:
Publisher:
ci.yml on AI-Colleagues/orcheo
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
orcheo-0.45.0a2-py3-none-any.whl -
Subject digest:
a8f78e18bb11074d5e9734d1d3cca4b7b97a75820a0502178494172283539d94 - Sigstore transparency entry: 2267193943
- Sigstore integration time:
-
Permalink:
AI-Colleagues/orcheo@52408f462658c20c2f632cd45c0a018c4edd90e6 -
Branch / Tag:
refs/tags/core-v0.45.0a2 - Owner: https://github.com/AI-Colleagues
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@52408f462658c20c2f632cd45c0a018c4edd90e6 -
Trigger Event:
push
-
Statement type:
