Back to Docs

Getting Started

Installation

Quick Start with npx

npx botatos gateway --bind lan

Install with npm

npm install -g botatos
botatos gateway --bind lan --port 18789

Docker

docker run -p 18789:18789 botatos/botatos gateway --bind lan

First Steps

  1. Open the dashboard at http://localhost:18789
  2. Add your AI provider API key (OpenAI, Anthropic, etc.)
  3. Connect a messaging channel (Telegram is easiest to start)
  4. Send a message — your AI bot will reply!

Configuration

Create ~/.botatos/botatos.json for persistent configuration:

{
  "model": "gpt-4o-mini",
  "systemPrompt": "You are a helpful assistant.",
  "channels": {
    "telegram": { "token": "YOUR_BOT_TOKEN" }
  }
}

Next Steps

Getting Started | Botatos