Quickstart

Get MeepaGateway running and connected to a chat platform.

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.