This project integrates a Discord bot with the Ollama API to provide an interactive chatbot experience. Users can interact with the bot in designated channels by mentioning it, enabling dynamic conversations powered by advanced AI models.

Before starting, ensure you have the following:

• Node.js: Install Node.js version 14 or higher. Node.js is essential for running JavaScript on the server. Download Node.js
• Ollama: This project uses Ollama for AI model serving. Follow the installation instructions on the Ollama GitHub page.

1. Clone the Repository: Start by cloning this repository to your local machine using git clone, followed by the repository URL.
2. Install Dependencies: Navigate to the cloned repository's directory in your terminal and run npm install to install all required dependencies.
3. Model Setup: Pull your desired AI model using Ollama. For example, use ollama pull orca or ollama pull llama2 to download specific models. This step requires Ollama to be installed and properly configured on your system.
4. Start Ollama: With your model downloaded, start the Ollama server by running ollama serve. This command initializes the model server, making it ready to handle requests from your Discord bot.

1. Create a Discord Bot: Visit the Discord Developer Portal and create a new application. Navigate to the "Bot" section and add a new bot to your application.
2. Configure Intents: Enable both the "Message Content Intent" and "Server Members Intent" to allow your bot to read message content and access server member information.
3. Invite the Bot to Your Server:
   • In the Discord Developer Portal, go to "Application" > "OAuth2" > "URL Generator".
   • Select the "bot" scope and permissions "Send Messages", "Read Messages/View Channels", and "Read Message History".
   • Copy the generated URL, paste it into your web browser, and follow the prompts to invite your bot to a server.

1. Environment Variables: Rename the .env.example file to .env. This file contains environment variables crucial for configuring your bot's behavior.
2. Configure .env Variables: Edit the .env file with your preferred text editor and update the variables:
   • TOKEN: Your Discord bot token, found in the Discord Developer Portal under "Bot" > "Token".
   • CHANNELS: The IDs of the Discord channels you want the bot to listen to. Enable Developer Mode in Discord under User Settings > Advanced to copy IDs.
   • OLLAMA: The URL(s) of your Ollama server(s), separated by commas if using multiple.
   • MODEL: The identifier for the AI model you wish to use with the bot. This should match one of the models you have pulled and are serving with Ollama.
   • Additional variables as described in the .env Variables section of the README.

1. Launch: With all configurations in place, start your bot by running npm start in the terminal. Your bot should now be online and responsive in the specified Discord channels.

For users who prefer Docker for deployment, follow these steps to ensure a smooth setup:

1. Install Docker: First, make sure Docker and Docker Compose are installed on your machine. Your Docker Engine should be at least version 1.13.0+, compatible with Docker Compose version 3 or higher. This compatibility is crucial for running the Dockerized version of the bot without issues. Download and install Docker here.

2. Pre-Setup Checks: Before proceeding with Docker, complete the initial setup steps mentioned in the Basic Setup and Discord Bot Configuration sections. This includes cloning the repository, setting up your .env file, and ensuring your AI model is pulled and ready.

3. Starting the Bot with Docker:

   • With Make: If you have Make installed, you can simplify the Docker Compose process. Navigate to your project directory in the terminal and run the following command:

     make compose-up
     

     This command utilizes a Makefile to run Docker Compose commands, streamlining the process of building and starting the bot.

   • Without Make: If you do not have Make installed, you can directly use Docker Compose to start the bot. Ensure you're in the project directory and run:

     docker compose -p discord-ai up
     

     This command tells Docker Compose to start the services defined in your docker-compose.yml file under the project name discord-ai.

By following these Docker setup instructions, you can deploy the Discord AI Bot in a Docker container, leveraging Docker's environment consistency and ease of deployment. Remember, running the bot with Docker means you won't use npm start; instead, Docker handles the process of bringing your bot online.

After completing the setup, your Discord AI Bot is ready. You can begin interacting with the bot by mentioning it in a message or sending a message within the configured channels. The bot will respond based on the AI model's capabilities, the .env file configuration, and the provided queries.

• Protect Your Token: The Discord bot token is akin to a password. Never share it or commit it to public repositories.
• Enable Developer Mode in Discord: To copy channel IDs for the CHANNELS variable, enable Developer Mode in Discord under User Settings > Advanced.
• Use Secure Connections: When connecting to Ollama or any external service, ensure your connections are secure.