Installation

CLI

Quick install (standalone binary)

curl -fsSL https://synapsex.ai/install | bash
synapsex --version
Downloads a standalone binary for your platform (macOS, Linux, Windows). No Node.js or Python required.

Developer CLI

npm install -g synapsex-cli
synapsex --version
From source:
git clone https://github.com/softquantus/synapsex.ai
cd synapsex.ai/apps/agents-synapsex/shared/cli
npm install
npm run build
node bin/synapsex.js --help

VM/Ops CLI

pip install synapsex-cli
sx --version
From source:
cd agents/vm-cli
pip install -e .
sx --help

Orchestrators (Backend)

Requirements

  • Python 3.11+
  • PostgreSQL 15+
  • Redis 7+

Local setup

cd apps/agents-synapsex
pip install -e ".[dev]"
cp .env.example .env
# Edit .env with your API keys
uvicorn services.api-gateway.main:app --reload --port 8080

Platform Dashboard

cd apps/management-console
npm install
cp .env.local.example .env.local
npm run dev
# Open http://localhost:3000

Docker (All services)

docker compose up -d
Services started:
  • synapsex-orchestrator — port 8090
  • synapsex-manager — port 8000
  • mcp-bridge — port 8080
  • postgres — port 5435
  • redis — port 6381