Skip to main content
GenosOS is a self-hosted AI assistant that connects to WhatsApp, Telegram, Slack, Discord, Signal, iMessage, and more — all from a single gateway running on your hardware. Your conversations stay private, encrypted at rest with AES-256-GCM, and configured through natural language rather than config files or dashboards.

Quick Start

Get GenosOS running in under five minutes — from install to first conversation.

Connect Channels

Link WhatsApp, Telegram, Slack, Discord, Signal, and more to your assistant.

AI Providers

Choose from Anthropic, OpenAI, or Gemini — paste one API key and you’re done.

Agents & Skills

Create specialized agents for your business with 12 ready-made templates.

​
Why GenosOS?

Most AI assistants are stateless, cloud-only, and require technical setup. GenosOS is different:
  • Runs on your hardware — your conversations never leave your machine
  • Encrypted by default — AES-256-GCM encryption at rest, not optional
  • Remembers you — persistent memory with semantic search across sessions
  • Works across channels — one assistant, all your messaging apps
  • Configured by talking — say “connect my WhatsApp” instead of editing JSON
1

Install Bun and clone the repo

Install the Bun runtime, then clone and set up GenosOS with a single command.
curl -fsSL https://bun.sh/install | bash
git clone https://github.com/estebanrfp/genos.git && cd genos
pnpm setup
2

Start the gateway

Launch the gateway. On first run, you’ll be prompted to choose a provider and paste your API key.
bun genosos.mjs gateway
3

Open the interface and start chatting

The browser opens automatically at http://127.0.0.1:18789. Everything else — connecting channels, creating agents, configuring security — happens through conversation.

​
Explore the docs

Installation guide

Detailed setup for macOS, Linux, and Raspberry Pi.

Voice calls

Set up bidirectional phone calls via Twilio, Telnyx, or OpenAI Realtime.

Security & vault

Understand the NYXENC1 vault, Fortress Mode, and WebAuthn/Touch ID.

CLI reference

Full reference for every genosos command and subcommand.