InfiniBot — Personal AI Assistant

A personal AI control room you run on your own machine. Chat, voice, video editing, business CRM, kanban projects, mobile companion app, federation across devices, and ~20 more features — all behind one local gateway. Your keys, your data, your hardware.

InfiniBot answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat). It can speak and listen on macOS/iOS/Android, render a live Canvas, edit videos, manage your business pipeline, and run autonomous tasks in the background.

📘 The friendly setup walkthrough lives at setup.html — open it in any browser for a one-page guided installer with copy-buttons, FAQ, and a feature tour. Below is the fast-path for developers cloning the repo.

Pick your path

| You want… | Go to | |---|---| | The easiest install (no clone needed) | Install via npm | | Run from source after git clone | Run from source | | A guided walkthrough with screenshots | Open setup.html in your browser | | Just spin it up in Docker | Docker quickstart (coming soon) |

1 · Install via npm (easiest)

If you don't need to modify the source, this is the shortest path. Requires Node ≥ 22.

npm install -g infinibot@latest
infinibot onboard --install-daemon

The wizard walks you through every choice (model provider, channels, skills) and installs InfiniBot as a background service (launchd on macOS, systemd on Linux, scheduled task on Windows). When it finishes, it opens the dashboard at http://127.0.0.1:18789.

Subscriptions (recommended): Anthropic Claude Pro/Max for the smartest agent, OpenAI as a fallback. Single keys also work — paste them in the wizard.

2 · Run from source

You cloned the repo. Here's the 5-minute path to a running gateway:

# 1. Install dependencies (uses pnpm — install it once if you don't have it)
npm install -g pnpm
pnpm install

# 2. Set your API key (the agent needs at least one)
export ANTHROPIC_API_KEY="sk-ant-..."         # macOS / Linux
# Windows PowerShell:
# $env:ANTHROPIC_API_KEY = "sk-ant-..."

# 3. Pick a gateway password (anything memorable — you'll type it in the dashboard)
export GATEWAY_PASSWORD="Kingly888$"

# 4. Start the gateway. It auto-builds TypeScript on first run (~30s).
pnpm start gateway --auth password --password "$GATEWAY_PASSWORD"

# 5. Open the dashboard
#    macOS:    open http://127.0.0.1:18789
#    Linux:    xdg-open http://127.0.0.1:18789
#    Windows:  start http://127.0.0.1:18789

Type your gateway password on the login screen → you're in.

What you'll see first

The Welcome walkthrough auto-loads on the /learn page — five short steps that teach you the navigation, send your first message, set your language preferences, and point you at the deeper guides. Total time: ~5 minutes.

From there, pick whichever feature matters to you:

• 💬 Chat & Sessions — single chat, multi-session grid, voice, sub-agents
• 🎬 Video Studio — composition editor, AI asset analysis, ComfyUI rendering
• 📋 Projects & Kanban — agent-runnable tasks with criticality + GitHub precheck
• 💼 Business Center — multi-business CRM, Whop/Stripe income sync, Notion two-way
• 📱 Mobile — Expo Go QR pairing or build a personal IPA
• 🌐 Federation — pair multiple machines into one agent fabric
• 🎓 Learn — 19 interactive walkthroughs + a Master Certification

Every feature has a step-by-step walkthrough on the /learn page. Complete the cert-required tracks and the system mints an InfiniBot AI Agent Systems Master certificate with your name and a verification fingerprint.

Common flags

# Accept connections from your LAN (default: localhost only)
pnpm start gateway --bind lan --auth password --password "..."

# Federation master mode — accept satellite pairings from other machines
pnpm start gateway --master-mode --bind lan --tailscale on --auth password --password "..."

# Disable Tailscale binding (if you don't have it installed)
pnpm start gateway --bind lan --tailscale off --auth password --password "..."

# Custom port
pnpm start gateway --port 47913 --auth password --password "..."

Recommended .env for local dev

Drop this in the repo root as .env so you don't have to export keys every shell:

# Required for the agent to talk
ANTHROPIC_API_KEY=sk-ant-...

# Optional — fall through to these when Anthropic rate-limits
GEMINI_API_KEY=...
OPENROUTER_API_KEY=...

# Optional — voice (TTS), revenue providers, image generation
ELEVENLABS_API_KEY=...
STRIPE_SECRET_KEY=sk_...
WHOP_API_KEY=...
GEMINI_API_KEY=...                      # also powers Nano Banana image gen if you have it
COMFY_URL=http://127.0.0.1:8000         # local ComfyUI for storyboard / video studio

.env is gitignored. The gateway loads it on startup.

3 · Docker quickstart

Not shipped yet — see issue tracker for status. For now, the source-run path above is the fastest start.

What's actually inside

InfiniBot ships ~20 production-ready feature areas. The full list with a one-line description per feature lives in docs/index.md. Highlights:

| Surface | What it does | |---|---| | Chat / Voice / Grid | Multi-model, multi-session, multi-device chat with wake-word voice | | Projects | Kanban with agent-runnable tasks, GitHub precheck, criticality gates | | Business | Multi-business CRM, revenue sync (Whop/Stripe/Square), Notion two-way | | Video Studio | Composition editor, AI asset analysis, ComfyUI image gen, ProRes render | | Storyboard | End-to-end AI video: prompt → script → scenes → images → VO → MP4 | | Federation | Master/satellite topology, Tailscale meshing, cross-device sessions | | Mobile | Expo Go QR pairing + EAS Build for personal IPAs | | Multi-user | Per-user home dirs, page gating, agent directory locking, language/context | | Learn | 19 interactive walkthroughs + Master certification | | Apps registry | Unified catalog of every project/site/directory you've built | | Skills + MCP | Claude Code skills + MCP servers for richer agent tool surfaces | | Cron + Autonomy | Scheduled tasks, idle-detection-driven work, Telegram approval gates | | Vault | Run a paid community/courses/membership product locally | | Funnels | Sales funnels with AI lead qualification + KPI tracking |

Each one has a dedicated page in the dashboard and a step-by-step walkthrough in /learn.

Documentation

• 📘 setup.html — friendly one-page setup with copy-buttons + FAQ
• 📚 docs/index.md — full feature index
• 🎓 /learn (in-app) — 19 interactive walkthroughs from beginner → master
• 🛠 docs/QUICKSTART.md — single-command install
• 🌐 docs/federation.md — multi-device setup
• 📱 docs/storyboard.md — AI video pipeline

Use infinibot doctor to diagnose a misbehaving install.

Operating systems

| OS | Status | Notes | |---|---|---| | macOS (12+) | ✅ Native | iMessage, voice wake-word, all features | | Linux | ✅ Native | All features except iMessage | | Windows 11 | ✅ Native | Most features. WSL2 strongly recommended for federation + mobile | | Windows 10 | ⚠️ Use WSL2 | Native install works but some helpers expect bash |

Runtime: Node 22+. Works with npm, pnpm, or bun.

Troubleshooting

| Symptom | Fix | |---|---| | unknown method: ... on first request | Restart the gateway after pnpm install so the methods registry rebuilds | | Login screen rejects your password | Stop the gateway, restart with --password "<your-password>" — passwords aren't read from .env | | ComfyUI not reachable in storyboard / video studio | Default URL is http://127.0.0.1:8000. Override with COMFY_URL=http://your-host:port | | Voice mode says "no Claude terminal selected" | Voice auto-spawns one when you Connect — give it 2 seconds | | Federation satellite won't pair | Check master is running with --master-mode and the password matches on both sides | | Anything else | infinibot doctor runs every diagnostic and prints what's wrong |

Contributing

Pull requests welcome. The project is a TypeScript monorepo (gateway server in src/, dashboard UI in ui/src/). Run pnpm test before sending PRs. See CONTRIBUTING.md.

License

MIT — see LICENSE.

"It's not a tool. It's a control room." — InfiniBot