Platforms

OpenSoul core is written in TypeScript. Node is the recommended runtime. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

Companion apps exist for macOS (menu bar app), Windows (native WPF app), and mobile nodes (iOS/Android). Linux companion app is planned; the Gateway is fully supported on all platforms.

Choose your OS

• macOS: macOS
• iOS: iOS
• Android: Android
• Windows: Windows
• Linux: Linux

VPS & hosting

• VPS hub: VPS hosting
• Fly.io: Fly.io
• Hetzner (Docker): Hetzner
• GCP (Compute Engine): GCP
• exe.dev (VM + HTTPS proxy): exe.dev

Common links

• Install guide: Getting Started
• Gateway runbook: Gateway
• Gateway configuration: Configuration
• Service status: opensoul gateway status

Gateway service install (CLI)

Use one of these (all supported):

• Wizard (recommended): opensoul onboard --install-daemon
• Direct: opensoul gateway install
• Configure flow: opensoul configure → select Gateway service
• Repair/migrate: opensoul doctor (offers to install or fix the service)

The service target depends on OS:

• macOS: LaunchAgent (ai.opensoul.gateway or ai.opensoul.<profile>; legacy com.opensoul.*)
• Linux/WSL2: systemd user service (opensoul-gateway[-<profile>].service)