Platforms

OpenAEON 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) and mobile nodes (iOS/Android). Windows and Linux companion apps are planned, but the Gateway is fully supported today. Native companion apps for Windows are also planned; the Gateway is recommended via WSL2.

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: openaeon gateway status

Gateway service install (CLI)

Use one of these (all supported):

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

The service target depends on OS:

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