> ## Documentation Index
> Fetch the complete documentation index at: https://meepa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get MeepaGateway running and connected to a chat platform.

## Prerequisites

* MeepaGateway installed — see [Install](/gateway/install)
* An LLM API key (Anthropic or OpenAI)
* A bot account on your chat platform

## First run

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="CLI Reference" icon="terminal" href="/gateway/cli">
    Manage agents, connectors, skills, and more from the terminal.
  </Card>

  <Card title="Configuration" icon="gear" href="/gateway/configuration">
    Full reference for all config options.
  </Card>

  <Card title="Captain Dashboard" icon="gauge" href="/gateway/captain">
    Web UI for managing your gateway.
  </Card>

  <Card title="Connectors" icon="plug" href="/gateway/connectors">
    Platform-specific connector setup guides.
  </Card>
</CardGroup>