Justin Napolitano

A Discord bot implemented in Python that integrates with an external assistant API to provide interactive slash commands. Designed for deployment with Docker and supports rapid development via guild-specific command registration.

Features

Slash command-based interaction (no message content reading).
Integration with an external assistant API for text analysis.
Health check command (/ping).
Development-friendly command syncing scoped to specified guilds.
Containerized deployment with Docker and Docker Compose.

Tech Stack

Python 3
discord.py library
httpx for asynchronous HTTP requests
Docker & Docker Compose

Getting Started

Prerequisites

Python 3.8+ (if running locally)
Docker and Docker Compose (for containerized deployment)
Discord Bot Token and Application ID

Installation

Clone the repository:

git clone https://github.com/justin-napolitano/discord-bot.git
cd discord-bot

Create a .env file based on env-example.txt and set the following environment variables:

DISCORD_BOT_TOKEN=your_discord_bot_token
DISCORD_APP_ID=your_discord_application_id
DEV_GUILD_IDS=comma_separated_dev_guild_ids (optional)
ASSISTANT_API_BASE=http://assistant-core:8088

Running Locally

Install dependencies:

pip install -r requirements.txt

Run the bot:

python bot.py

Running with Docker Compose

Build and start the containers:

docker-compose up --build

This will start the discord-bot service and link it with the assistant-core service on the assistant-net network.

Project Structure

discord-bot/
├── bot.py               # Main bot implementation
├── Dockerfile           # Docker image definition for the bot
├── docker-compose.yml   # Docker Compose configuration
├── env-example.txt      # Example environment variables file
└── requirements.txt     # Python dependencies

bot.py contains the bot logic, including command registration and interaction with the assistant API.
Dockerfile and docker-compose.yml enable containerized deployment.
env-example.txt provides a template for required environment variables.

Future Work / Roadmap

Expand command set beyond /ping and /ask.
Implement message content command support if needed.
Add logging and error handling improvements.
Support dynamic configuration for assistant API base URL.
Add automated tests and CI/CD integration.
Improve documentation and usage examples.

For questions or contributions, please open an issue or submit a pull request.

This README is generated based on current repository state and may be updated as the project evolves.