Genesis Docs

Genesis documentation

Self-hosted gateway docs for AI agents.

Install Genesis, connect chat channels, run the Gateway, and operate the agent surface from one GitHub Pages site.

Get started Browse all docs GitHub
Genesis npm install -g @pixelzx/genesis@latest genesis onboard --install-daemon genesis dashboard

Start here

Common paths

Guide Getting started Get Genesis installed and run your first chat in minutes. Guide Onboarding (CLI) CLI onboarding: guided setup for gateway, workspace, channels, and skills Guide Install Install Genesis — installer script, npm/pnpm/bun, from source, Docker, and more Guide Chat channels Messaging platforms Genesis can connect to Guide Control UI Browser-based control UI for the Gateway (chat, nodes, config) Guide Configuration Configuration overview: common tasks, quick setup, and links to the full reference

Directory

Docs by area

Get started Genesis is a self-hosted gateway that connects chat apps to AI agents. Install Install Genesis — installer script, npm/pnpm/bun, from source, Docker, and more Channels Messaging platforms Genesis can connect to Agents WebSocket gateway architecture, components, and client flows Tools & Plugins Genesis tools and plugins overview: what the agent can do and how to extend it Models Model providers (LLMs) supported by Genesis Platforms Platform support overview (Gateway + companion apps) Gateway & Ops Runbook for the Gateway service, lifecycle, and operations Reference Genesis CLI index: command list, global flags, and links to per-command pages Help Help hub: common fixes, install sanity, and where to look when something breaks

Genesis

Genesis

One self-hosted gateway. Your favorite chat apps. An AI assistant that is always on.
Run Genesis on your own machine and message it from Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more.

Get started  ·  See what people build  ·  GitHub

New here? The shortest path is `npm install -g @pixelzx/genesis@latest` then `genesis onboard`. Five minutes to a working assistant.

What Genesis is

Genesis is a local-first control plane that sits between your chat apps and an AI agent. You start one Gateway process, connect the channels you already use, and the same agent answers from your phone, your terminal, or a browser dashboard.

  • You stay in control The Gateway runs on hardware you own. Your messages, sessions, and credentials never leave your machine unless you point them at a remote host.

  • One agent, many channels Discord, iMessage, Signal, Slack, Telegram, WhatsApp, and more share a single session, memory, and tool surface. No per-channel bots to maintain.

  • Agent-native by design Built for coding and tool-using agents: workspace isolation, multi-agent routing, session memory, and approval gates out of the box.

  • Extensible through plugins Add channels, providers, or skills as plugins. Bundled plugins ship with Genesis, and you can drop in your own.

Run it in three steps

Install

Requires Node 24 (recommended) or Node 22 LTS (`22.14+`).

```bash
npm install -g @pixelzx/genesis@latest
```

Onboard

The wizard installs the Gateway as a system service, sets up your workspace, and walks you through pairing your first channel.

```bash
genesis onboard --install-daemon
```

Chat

Open the dashboard locally, or message the bot from a paired channel like Telegram.

```bash
genesis dashboard
# open http://127.0.0.1:18789/
```

Need remote access? See [Web surfaces](/web) and [Tailscale](/gateway/tailscale).

Full developer setup, dev-loop, and source build instructions live in Getting started.

Channels

Pair any of these. Each is a first-class channel with its own pairing flow and configuration.

What it can do Run isolated agents per channel, workspace, or sender. Each agent keeps its own session, memory, and tool policy.

  • Live canvas and voice Pair iOS and Android nodes for Canvas, camera, voice wake, and push-to-talk. The agent drives a visual surface you control.

  • Sandbox and approvals Lock down non-main sessions with Docker, SSH, or OpenShell backends. Approve sensitive tool calls before they run.

  • Cron, hooks, and skills Schedule recurring jobs, react to events with hooks, and teach the agent new skills with markdown files.

See it in the wild

People ship real things on Genesis: PR review loops, mobile apps, home automation, voice systems, and chat-native devtools.

  • Browse the showcase Watch walkthroughs, read project breakdowns, and get a feel for what is possible.

Go further