Skip to main content

​
Prerequisites

  • MeepaGateway installed — see Install
  • An LLM API key (Anthropic or OpenAI)
  • A bot account on your chat platform

​
First run

meepagateway
On first run with no config file, you’ll be prompted to choose a setup method:
  • [1] Terminal wizard — interactive step-by-step in your terminal
  • [2] Web dashboard — opens the Captain Dashboard at http://localhost:63372
Both walk you through configuring your LLM provider, creating an agent, and connecting to a chat platform. To re-run setup later: 
meepagateway setup

​
Terminal wizard

The wizard prompts for:
  1. LLM provider — Anthropic or OpenAI, your API key env var, and model
  2. Agent name — display name for your first agent
  3. Platform connector — MeepaChat, Discord, Telegram, Slack, or WhatsApp, and the credentials for that platform
  4. Dashboard password — for the Captain web UI
After completing the wizard, the gateway starts and connects to your platform.

​
Captain Dashboard setup

If you chose the web dashboard, open http://localhost:63372/setup and enter the setup code printed in your terminal: 
============================================
FIRST-TIME SETUP
============================================
Open http://127.0.0.1:63372/setup
Setup code: ABC-123-XYZ
============================================
The dashboard walks you through the same steps as the terminal wizard.

​
Test the bot

Once running, send a message to your bot in the configured platform. The agent will respond based on its soul and LLM provider. Check gateway health: 
curl http://localhost:63372/health
# {"status":"ok","version":"..."}

​
What was created

After setup, your agent workspace lives at ~/.meepagateway/agents/{id}/: 
agent.yaml               # Per-agent config overrides
SOUL.md                  # Agent personality — edit this to change behavior
MEMORY.md                # Long-term notes
USER.md                  # User profile
memory.db                # SQLite fact store
skills/                  # Installed skill files
.mcp.json                # MCP server configuration
AGENTS.md                # Auto-generated capabilities reference
secrets.yaml             # SOPS-encrypted secrets
private-key.key          # Agent credential key
The global config is at ~/.meepagateway/config.yaml.

​
Next steps

CLI Reference

Manage agents, connectors, skills, and more from the terminal.

Configuration

Full reference for all config options.

Captain Dashboard

Web UI for managing your gateway.

Connectors

Platform-specific connector setup guides.