Skip to content

Environment Configuration

To operate autonomously, Emmu requires access to Large Language Models (LLMs) and Model Context Protocol (MCP) servers. Configuration is handled through standard .env and JSON configuration files.

[!IMPORTANT] Emmu requires high-tier reasoning models to function reliably. We strongly recommend configuring Groq (for high-speed inference) or OpenRouter (for routing to Claude 3.5 Sonnet / GPT-4o).


1. The Environment File (.env)

The .env file holds your API keys, base URLs, and platform integration secrets (e.g., Discord or Bug Bounty tokens).

Step 1: Initialize the Configuration

Copy the provided example file to create your local environment file:

cp .env.example .env

Step 2: Configure AI Providers

Open .env in your preferred editor and supply your API keys. Emmu's Agent Factory uses these keys to spin up its specialists.

# Primary High-Speed Inference (Recommended)
GROQ_API_KEY="gsk_..."
GROQ_MODEL="llama-3.3-70b-versatile"

# Secondary/Heavy Reasoning Inference
OPENROUTER_API_KEY="sk-or-v1-..."
OPENROUTER_MODEL="anthropic/claude-3.5-sonnet"

# Optional: Local Models
LMSTUDIO_API_BASE="http://localhost:1234/v1"
LMSTUDIO_MODEL="qwen2.5-3b-instruct"

Step 3: Platform Integrations (Optional)

If you intend to use Emmu's Discord C2 features or Bug Bounty automated reporting:

DISCORD_BOT_TOKEN="MTEz..."
HACKERONE_USERNAME="your_username"
HACKERONE_API_TOKEN="your_token"

2. MCP Server Configuration (mcp.json)

The Problem: AI models cannot inherently execute local binaries or parse complex memory dumps. The Solution: Emmu relies on the Model Context Protocol (MCP) to wrap native security tools (like Ghidra, JADX, or Nuclei) into standardized JSON-RPC servers that the AI can interact with.

Step 1: Initialize the MCP Config

cp mcp.json.example mcp.json

Step 2: Define MCP Tools

Inside mcp.json, define the servers you want Emmu to have access to. Emmu will parse this file at boot and inject these tools into its active Specialists.

{
  "mcpServers": {
    "ghidra-mcp": {
      "command": "python3",
      "args": ["-m", "ghidra_mcp_server"]
    },
    "nuclei-mcp": {
      "command": "nuclei-mcp",
      "args": ["serve"]
    }
  }
}

[!TIP] Emmu automatically maps MCP capabilities. If a specific mission requires Android reverse engineering, Emmu will look for a jadx-mcp or similar server declared in your mcp.json.


Next Steps

With your API keys and MCP servers configured, you are ready to launch the platform. Proceed to the Quick Start Guide.