Genesis core is written in TypeScript. Node is the recommended runtime. Bun is not recommended for the Gateway — known issues with WhatsApp and Telegram channels; see Bun (experimental) for details.
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
VPS & hosting
- VPS hub: VPS hosting
- Fly.io: Fly.io
- Hetzner (Docker): Hetzner
- GCP (Compute Engine): GCP
- Azure (Linux VM): Azure
- exe.dev (VM + HTTPS proxy): exe.dev
Common links
- Install guide: Getting Started
- Gateway runbook: Gateway
- Gateway configuration: Configuration
- Service status:
genesis gateway status
Gateway service install (CLI)
Use one of these (all supported):
- Wizard (recommended):
genesis onboard --install-daemon - Direct:
genesis gateway install - Configure flow:
genesis configure→ select Gateway service - Repair/migrate:
genesis doctor(offers to install or fix the service)
The service target depends on OS:
- macOS: LaunchAgent (
ai.genesis.gatewayorai.genesis.<profile>; legacycom.genesis.*) - Linux/WSL2: systemd user service (
genesis-gateway[-<profile>].service) - Native Windows: Scheduled Task (
Genesis GatewayorGenesis Gateway (<profile>)), with a per-user Startup-folder login item fallback if task creation is denied