Skip to main content

Junkie Documentation

Build intelligent Discord experiences with multi-agent AI orchestration, secure code execution, and comprehensive context management

Get StartedExplore Architecture

Quick start

Get Junkie running in minutes with these simple steps

1

Clone the repository

Clone the Junkie repository from GitHub:
git clone https://github.com/maanya0/junkie.git
cd junkie
2

Configure environment variables

Create a .env file with your Discord token and API keys:
DISCORD_TOKEN=your_discord_token
GROQ_API_KEY=your_groq_api_key
CUSTOM_PROVIDER_API_KEY=your_openai_api_key
POSTGRES_URL=your_postgres_connection_string
E2B_API_KEY=your_e2b_api_key
See the environment configuration guide for all available options.
3

Install dependencies

Install Python dependencies using pip or uv:
pip install -r requirements.txt
4

Run the bot

Start Junkie with the main entry point:
python main.py
The bot will connect to Discord and begin processing commands with the ! prefix.

Key features

Powerful capabilities for building intelligent Discord bots

Multi-agent orchestration

Deploy specialized AI agents for code execution, web search, and context analysis that work together seamlessly

E2B sandbox execution

Run Python code and shell commands in secure, isolated sandboxes with full file system access

Context-aware responses

Maintain conversation history with PostgreSQL-backed caching and intelligent context retrieval

Memory persistence

Store and recall user-specific information across sessions with automatic memory management

TL;DR summaries

Generate conversation summaries on demand with the .tldr command

Phoenix tracing

Monitor agent performance and debug interactions with integrated observability

Architecture overview

Understand how Junkie’s components work together

Team system

Learn how the multi-agent team orchestrates specialized agents

Agent roles

Explore the specialized agents and their capabilities

Context management

Understand message caching and history retrieval

Integrations & tools

Extend Junkie with powerful external services

MCP tools

Connect to Model Context Protocol servers for extended capabilities

Web search

Access real-time information with Perplexity Sonar and Exa search

Code execution

Run code securely with E2B sandboxes and Groq Compound

User tools

Fetch Discord user profiles, avatars, and status information

Resources

Additional materials to help you succeed

API reference

Complete API documentation for all core modules

Deployment guide

Deploy Junkie to production with Docker or Railway

Ready to get started?

Follow our quickstart guide to deploy your first AI-powered Discord bot in minutes

Get Started