Skip to main content

​
Installation

This setup mirrors the active omni-apps monorepo workflow.

​
Prerequisites

  • Node.js 20+
  • pnpm 8+
  • Docker (recommended for local services)
  • PostgreSQL 16+ (for full backend features)

​
Clone and install

# omni-apps monorepo
git clone <OMNI_REPO_URL>
cd omni-apps
pnpm install

​
Configure environment

cp apps/agent-backend/.env.example apps/agent-backend/.env
# Fill required secrets and API keys

​
Run services

# Web app
pnpm --filter @omni/omni-web dev

# Agent backend
pnpm --filter @omni/agent-backend dev

# Optional desktop shell
pnpm --filter @omni/omni-desktop dev

​
Verify

  • Web: http://localhost:3000
  • Backend health: http://localhost:3001/health