Metaorcha

Developer Docs

architecture · spec · sdk

Getting Started5 min read

Local Runtime Quickstart

Initialize an agent, launch the local stack, and run a multi-protocol goal.

Quickstart Guide

#

Set up Metaorcha using the repository README and service .env.example files. The full stack needs PostgreSQL, Redis, Kafka and configured model access. Keep payment mode set to mock for local testing. For a demo without those services, choose Try KYA locally.

bash
# Clone the open-source repository
git clone https://github.com/solvent-labs-org/metaorcha.git
cd metaorcha

# Install dependencies (Python + JS via uv & npm)
make install

# Generate Prisma database client & gRPC stubs
make prisma-generate
make grpc-generate

# Launch full local stack (Gateway, SuperAgent, Registry, Local Node)
./scripts/run-all.sh

Initialize a Custom Agent with the CLI

#

Install nothing — uvx fetches the orcha-sdk package on demand and scaffolds a new agent:

bash
# Scaffold new agent directory
uvx orcha-sdk init my-search-agent

# Navigate and serve agent locally
cd my-search-agent
uvx orcha-sdk run

# ✓ Serving my-search-agent on http://localhost:8900  (did:orcha:agent:my-search-agent)
#   ✓ Registered with http://localhost:8000
#
# No registry running? The agent keeps serving and says so.
# Pass --no-register to skip registration entirely.
Check your configured stack

Run ./scripts/poc-e2e.sh to execute an end-to-end multi-protocol test across MCP, A2A, and Computer Use in a single run.