Skip to content

Axyss/AutomatiK

Repository files navigation

AutomatiK logo

Discord bot that tracks free game offers across multiple platforms and notifies your server.

Important

🎉v2.0 is now out! Check out the release notes

Features

  • Rich Embeds: Game metadata powered by the IGDB API. Example
  • AI Fallback: Resilient parsing by relying on LLMs when standard methods fail. Currently supporting Google, Anthropic, and OpenAI models.
  • Minimal Permissions: No need for admin rights nor privileged intents.

Supported Platforms

  Steam Logo   Epic Games Logo   Humble Bundle Logo   Ubisoft Logo

Commands

/channel: Select/unselect the channel where notifications will be sent.
/services: Enable/disable specific platform notifications for your server.
/mention: Set/unset the role mentioned on notifications.
/language: Switch between languages.

Deployment

There's an existing bot instance that you can invite to your server. But in case you prefer to host your own, you can do so either via:

Docker (Recommended)

  1. Create a docker-compose.yml file with the following content:

    version: "3.9"
    services:
      mongo:
        image: mongo
        volumes:
          - mongo-data:/data/db
      bot:
        image: ghcr.io/axyss/automatik:latest
        depends_on:
          - mongo
        environment:
          DB_URI: "mongodb://mongo:27017"
          DISCORD_TOKEN: ""
    
          # Optional settings
          LLM_MODEL: "" # Examples: google:gemini-2.5-flash, openai:gpt-5-mini
          LLM_API_KEY: ""
    
          IGDB_CLIENT_ID: ""
          IGDB_CLIENT_SECRET: ""
    
          # Developer settings
          #DEBUG_MESSAGES: true
          #DEBUG_GUILD_ID: ""
    
    volumes:
      mongo-data:
  2. Fill DISCORD_TOKEN with your own token from the Discord Developer Portal.

  3. Launch the containers:

    docker-compose up -d

Manual Installation

Requirements: Python 3.12.10 and a MongoDB instance.

  1. Clone and install dependencies:
    git clone https://github.com/Axyss/AutomatiK.git && cd AutomatiK
    pip install -r requirements.txt
  2. Prepare your own .env file:
    cp .env.template .env
    Fill in your DISCORD_TOKEN and DB_URI in your newly .env file.
  3. Run the bot:
    python -m automatik.bot

License

This project is licensed under the MIT license.

About

Discord bot that tracks free game offers across multiple platforms and notifies your server.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors