README.md

Firka Polls Bot

The source code for the discord bot that automatically logs internal management polls.

Running the bot

If you would like to run to the bot yourself (why?), follow these steps:

1. Clone the project

git clone https://github.com/QwIT-Development/poll-bot.git

2. cd into the project folder

cd poll-bot

3. Add a dotenv file with your Discord bot token

On macOS / Linux:

echo "DISCORD_TOKEN=your_token_here" >> .env

On Windows (cmd):

echo DISCORD_TOKEN=your_token_here >> .env

PowerShell:

'DISCORD_TOKEN=your_token_here' >> .env

4. Initialize the virtual environment

This is easier if you use uv. If you're already using uv, just run uv venv.

Otherwise, run:

python3 -m venv .venv

5. Activate the virtual environment

⚠ You can exit the virtual environment with the deactivate command.️

On macOS / Linux:

source .venv/bin/activate

On Windows (cmd):

.venv\Scripts\activate.bat

PowerShell:

.venv\Scripts\Activate.ps1

If you see an error about execution policy, run this in an administrator PowerShell once:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

6. Install required packages

If you use uv like a gigachad:

uv pip install -r pyproject.toml

Otherwise:

python3 -m pip install -r pyproject.toml

7. Run the bot

python3 main.py

_{yippee ur done :D}
^{stuck in the virtual environment? check step 5}