orches character
Open Source · MIT License

AI agents that
work together

Build teams of AI agents that collaborate, delegate tasks, use tools, and produce results — all from a visual interface.

Get Started See Features
# Clone and run in two commands
git clone github.com/ysz7/orches
./start.sh

Backend ready on :8000
Frontend ready on :5173
SQLite database initialized
Orches — multi-agent workspace

Features

Everything you need to build
agent workflows

From a single agent answering questions to a full team researching, writing, and shipping.

Visual Agent Graph

See your entire agent network in a live, interactive graph. Watch tasks flow between agents in real time.

Delegation Chains

Agents delegate tasks to specialized sub-agents. The main agent coordinates, sub-agents execute. Configurable depth.

Built-in Workspace

Agents read and write files in a shared workspace. Upload files in chat, open results directly in Canvas.

Canvas

Agents present results as rich pages — Markdown, code, tables, charts, and a live browser — all inside the UI.

MCP Servers

Connect any MCP-compatible service — GitHub, Notion, Linear, databases, and more — and make those tools available to agents.

Memory

Agents remember context across sessions. Auto-summarization keeps history compact without losing important context.

📅

Scheduled Tasks

Schedule agent tasks with cron expressions or one-time datetimes. Works on SQLite and PostgreSQL equally.

Self-Assembly

Ask the main agent to build a team. It creates, configures, and registers new agents using the create_agent tool.

Multi-Provider Keys

Add API keys from any provider through the UI. Assign different models to different agents. Keys never touch git.


Providers

Works with any AI provider

Switch providers per-agent. Mix and match models based on cost, speed, or capability.

Anthropic
OpenAI
Google
Groq
Mistral
DeepSeek
Together AI
xAI (Grok)
Perplexity
Ollama (local)

Setup

Running in minutes

Two ways to run Orches — Docker for the easiest experience, or local with start.sh.

1

Clone the repository

git clone https://github.com/ysz7/orches.git && cd orches

2

Start with Docker or start.sh

Docker: docker compose up --build → open localhost:8000
Local: ./start.sh → open localhost:5173

No database setup. SQLite is used by default.

3

Add your API key

Go to Settings → API Keys, pick a provider, paste your key. That's it.

4

Start chatting

Type a message to the main agent. Ask it to research, write, create other agents, or use tools.

Start building

Open source. Self-hosted. No accounts required.

View on GitHub →