Skip to main content
MeepaGateway is a Rust application that runs AI agents and connects them to chat platforms. Each agent has its own personality, memory, skills, and platform connections. You manage everything from a web dashboard or the CLI.

​
Supported platforms

PlatformConnection method
MeepaChatWebSocket
DiscordWebSocket (gateway)
TelegramPolling or webhook
SlackSocket Mode
WhatsAppWebhook (Meta Cloud API)

​
Key features

Multi-agent — Run any number of agents from a single gateway instance. Each agent has its own config, soul, skills, memory, and connectors. Soul system — An agent’s personality and behavior are defined in a SOUL.md file in its workspace. Edit it to change how the agent thinks and responds. Skills — Agents load skill definition files from their skills/ directory. Skills extend what the agent can do with structured task patterns. Memory — Agents store facts in a SQLite database (memory.db) that persists across restarts. The store compacts automatically when it grows large. MCP (Model Context Protocol) — Connect agents to MCP servers for additional tools. Configured per-agent via .mcp.json. Sandbox — Agent tool calls run inside an OCI container for filesystem isolation. The image is built from a configurable package list. Cron — Schedule agents to run on an interval or cron expression. Useful for periodic tasks, digests, and autonomous workflows. Captain Dashboard — Built-in web UI for managing agents, config, skills, connectors, MCP, and cron. Runs at http://localhost:63372 by default. Provider routing — Configure multiple LLM providers (Anthropic, OpenAI, or any OpenAI-compatible endpoint) with automatic failover.

​
How it works

Each incoming message triggers an agent loop:
  1. The connector receives a message from the chat platform
  2. The agent reads its soul, memory, and skills
  3. The agent calls the LLM, executes tools as needed, and loops until done
  4. The response is sent back through the connector
Agent workspace layout: 
~/.meepagateway/
  config.yaml                # Global configuration
  agents/{id}/
    agent.yaml               # Per-agent config overrides
    SOUL.md                  # Personality and instructions
    MEMORY.md                # Long-term notes
    USER.md                  # User profile
    memory.db                # SQLite fact store
    skills/                  # Skill definition files
    .mcp.json                # MCP server configuration
    AGENTS.md                # Auto-generated capabilities reference
    secrets.yaml             # SOPS-encrypted secrets
    private-key.key          # Agent credential key