A Discord assistant for short answers, web lookup, and image generation. Supports slash commands, direct-message triggers, and localization.
- Features
- Requirements
- Setup
- Usage
- Development
- Testing
- Troubleshooting
- Security
- Configuration
- Operations
- Commands
- Events
- Intents and permissions
- Support
- Links
- License
Ask answers questions, looks up web results, summarizes text, rewrites text, and creates images in Discord.
Use Node.js 26 or later and npm 12 or later to run Ask from source. Create a Discord application and an OpenAI API key.
Follow the setup guide to configure Discord, set credentials, and start Ask.
Read the user guides for commands, configuration, and deployment. Read release notes for release history.
Read AGENTS.md for repository instructions. Read the documentation index and the specifications index for maintained guidance and requirements.
Run npm test to validate the repository.
Use the troubleshooting guide to resolve setup, Discord, and provider issues.
Keep Discord and OpenAI credentials private. Do not share tokens or private message content.
Set the required environment values. See the configuration guide for details.
Run node bin/ask.mjs from source or use Docker Compose. See the deployment guide for container instructions.
Use /ask query:<text> or /help. You can tag Ask, reply to an Ask message, or message Ask directly. See the command guide.
Ask handles commands and messages. It marks readiness after Discord connects and clears readiness when Discord invalidates a session. It logs warnings, errors, and debug events. See the user guides.
Ask requests the Guilds, GuildMessages, MessageContent, and DirectMessages intents. Enable Message Content and give the bot View Channels, Send Messages, and Read Message History in channels where it runs. Give the bot Attach Files for generated images and Embed Links for image previews. Ask does not require Administrator permission. See Discord access.
For help, questions, or to chat with the author and community, visit:


