GitHub

OpenAI chat, vision, image generation, transcription, moderation, and web search in Discord. Python **3.11–3.13** is supported.
Current API support
- /gpt ask and /gpt converse use current Chat Completions models, including vision and reasoning models. Defaults and model limits are centralized; incompatible sampling options are omitted for reasoning models.
- /web uses the **Responses API with native web search** and visible source links for recent information. It needs an OpenAI key with access to the chosen model and web search, with no Google account required. Search tool calls incur additional OpenAI charges.
- /dalle draw keeps the familiar command name and generates images with the current **GPT Image** API. Image bytes are sent as Discord attachments. Retired DALL·E endpoints are no longer used.
- Transcription and moderation use current OpenAI APIs. Long conversations, per-user keys, server roles, prompt optimization, and saved conversations remain available.
- Document indexing, Google/Wolfram chat, Pinecone memory, Replicate, and E2B code execution are optional integrations with separate dependencies.
The default chat model is gpt-6.1-sol, the low-cost helper model is gpt-6-luna, and image generation defaults to gpt-image-2.5-flare. Availability depends on your OpenAI project. Override models using the environment settings below. Model names and prices change; consult the OpenAI model catalog and pricing.
Run from source
Install FFmpeg with your operating system's package manager to transcribe downloaded media. The basic bot does not require Torch, Transformers, LlamaIndex, or LangChain.
The same code installs as the gpt3discord console command. Prompt files and conversation openers ship in the wheel; you can run the installed bot outside the source directory.
Required configuration
| Setting | Purpose |
| --- | --- |
| OPENAI_API_KEY | OpenAI project API key. OPENAI_TOKEN remains a supported alias. ChatGPT subscriptions do not include API billing. |
| DISCORD_TOKEN | Bot token from the Discord Developer Portal. |
| ALLOWED_GUILDS | Comma-separated Discord server IDs where commands are registered. |
| DATA_DIR | Writable directory for local data and usage estimates. Defaults to the current directory. |
Enable the **Server Members** and **Message Content** privileged gateway intents for the Discord application; invite the bot with the bot and applications.commands OAuth scopes and permissions to read/send messages, attach files, embed links, and create/use threads. Review the role controls in sample.env before inviting it to a public server. Debug guild/channel IDs are optional.
Keep credentials in an untracked .env or your hosting platform's secret store. GitHub credentials are unnecessary to run the basic bot or its tests. No passwords are required.
Model and project settings
OPENAI_BASE_URL supports compatible providers. Only configure endpoints you trust with your API credentials. Core chat keeps the Chat Completions response shape; /web requires a provider implementing Responses and native web search.
Optional integrations
Install the extras you use and configure their keys. Missing configured dependencies produce an actionable startup error; disabled services respond with setup guidance.
| Feature | Install | Configuration |
| --- | --- | --- |
| Document Q&A / indexes | pip install '.[index]' | ENABLE_INDEXING=true and OpenAI access |
| Google/Wolfram chat | pip install '.[search]' | GOOGLE_SEARCH_API_KEY, GOOGLE_SEARCH_ENGINE_ID; optionally WOLFRAM_API_KEY |