Skip to content

engineer-man/felix

Repository files navigation

Felix

Felix Discord Bot

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

  • Python 3.9 or higher

Installing

without docker

git clone https://github.com/engineer-man/felix.git
pip install -U -r requirements.txt

Duplicate config.json.sample and rename it config.json and update it with your own discord bot token.

Duplicate state.json.sample and rename it state.json.

cd python
Duplicate felix.sqlite.sample and rename it felix.sqlite.

Running the bot

Using python

cd python
python3 bot.py

Using Docker

docker-compose up

Creating your own python bot extension (cog)

This bot uses the discord.py API wrapper (https://discordpy.readthedocs.io/en/latest/)

You can create new bot commands or tasks by creating your own extension/cog.

Contributing to Felix

If you want to contribute to Felix you can just submit a pull request.

Code styling / IDE Settings

Please style your code according to these guidelines when writing python code for Felix:

  • maximum line length is 99 columns
  • use 4 spaces for indentation
  • files end with a newline
  • lines should not have trailing whitespace

If you want to use an auto formatter please use autopep8

Example config for VSCode:

"[python]": {
    "editor.rulers": [
        99
    ],
    "editor.tabSize": 4,
},
"files.insertFinalNewline": true,
"files.trimTrailingWhitespace": true,
"editor.trimAutoWhitespace": true,
"python.formatting.provider": "autopep8",
"python.formatting.autopep8Args": ["--max-line-length", "99"],

You can visit us on our discord: https://discord.gg/engineerman to ask questions and see felix in action.