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:
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:
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¶
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-mcpor similar server declared in yourmcp.json.
Next Steps¶
With your API keys and MCP servers configured, you are ready to launch the platform. Proceed to the Quick Start Guide.