eyeballdocs
Self-hosting

Local self-hosting quickstart

Build the workspace and run the executor, MCP gateway, dashboard, and optional provider mocks.

Build all main-workspace packages:

Bash
pnpm install
pnpm build

Start the executor with one local project key:

Bash
EYEBALL_API_KEYS="eyeball_local_key:proj_local" \
  PORT=3000 \
  pnpm --filter @eyeball/executor start

The stock server has no usable provider credential. For deterministic provider work, construct an executor with the development vault and point adapters at Mockhouse. For a controlled service identity, use EnvCredentialProvider.

In separate processes:

Bash
EYEBALL_API_KEYS="eyeball_local_key:proj_local:demo_user" \
EYEBALL_EXECUTOR_API_KEY="eyeball_local_key" \
EYEBALL_EXECUTOR_URL="http://127.0.0.1:3000" \
EYEBALL_USER_ID="demo_user" \
PORT=3001 \
pnpm --filter @eyeball/mcp-gateway start

EYEBALL_API_KEY="eyeball_local_key" \
EYEBALL_EXECUTOR_URL="http://127.0.0.1:3000" \
pnpm --filter @eyeball/dashboard start

Health-check the executor at GET /health, then use the SDK quickstart or connect an MCP client to http://127.0.0.1:3001/mcp.