Skip to content
eliwarePublic

About

A Discord assistant for short answers, web lookup, and image generation. Supports slash commands, direct-message triggers, and localization.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

eliware.org

@eliware/ask License CI

A Discord assistant for short answers, web lookup, and image generation. Supports slash commands, direct-message triggers, and localization.

Table of Contents

Features

Ask answers questions, looks up web results, summarizes text, rewrites text, and creates images in Discord.

Requirements

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.

Setup

Follow the setup guide to configure Discord, set credentials, and start Ask.

Usage

Read the user guides for commands, configuration, and deployment. Read release notes for release history.

Development

Read AGENTS.md for repository instructions. Read the documentation index and the specifications index for maintained guidance and requirements.

Testing

Run npm test to validate the repository.

Troubleshooting

Use the troubleshooting guide to resolve setup, Discord, and provider issues.

Security

Keep Discord and OpenAI credentials private. Do not share tokens or private message content.

Configuration

Set the required environment values. See the configuration guide for details.

Operations

Run node bin/ask.mjs from source or use Docker Compose. See the deployment guide for container instructions.

Commands

Use /ask query:<text> or /help. You can tag Ask, reply to an Ask message, or message Ask directly. See the command guide.

Events

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.

Intents and permissions

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.

Support

For help, questions, or to chat with the author and community, visit:

Discordeliware.org

eliware.org on Discord

Links

License

MIT © Eliware

About

A Discord assistant for short answers, web lookup, and image generation. Supports slash commands, direct-message triggers, and localization.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages