Skip to main content
1

Install Bun

GenosOS requires Bun as its runtime. If you already have Bun >=1.2.0 installed, skip this step.
curl -fsSL https://bun.sh/install | bash
Verify the install:
bun --version
2

Install pnpm

GenosOS uses pnpm as its package manager.
npm install -g pnpm
3

Clone and set up the repo

git clone https://github.com/estebanrfp/genos.git
cd genos
pnpm setup
pnpm setup runs three things: pnpm install, pnpm build, and pnpm ui:build. It takes about a minute on first run.
4

Start the gateway

bun genosos.mjs gateway
On the very first run, a setup wizard walks you through choosing a provider and pasting your API key. You’ll pick from three options:
ProviderWhere to get a key
Anthropicconsole.anthropic.com → API Keys
OpenAIplatform.openai.com → API Keys
Google Geminiaistudio.google.com → Get API key
5

Open the Control UI

After the wizard completes, the browser opens automatically at http://127.0.0.1:18789. You’ll see a chat interface — this is your assistant.
6

Configure by talking

Everything from here is done conversationally. Some things to try:
"Connect my WhatsApp"
→ QR code appears, scan with your phone, done.

"Connect Telegram"
→ Agent guides you through @BotFather step by step.

"Harden security"
→ Fortress Mode activates: Keychain, audit log, auto-lock, rate limiting.

"Create an assistant for my dental clinic"
→ Specialized agent deployed with WhatsApp + voice + appointment handling.

​
What’s next?

Connect channels

Link WhatsApp, Telegram, Slack, Discord, Signal, and more.

AI providers

Switch providers or configure multiple API keys.

Agent templates

Deploy a specialized business agent from one of 12 templates.

Security & vault

Understand encryption, Fortress Mode, and WebAuthn.