Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vbe0201/vale.py

A bot to support Discord servers that I like.
https://github.com/vbe0201/vale.py

bot discord discord-bot discord-py python python3

Last synced: 1 day ago
JSON representation

A bot to support Discord servers that I like.

Awesome Lists containing this project

README

        


Vale.py


A bot to support Discord servers that I like.



 
 






---

### Installation
___
**Of course you can self-host the bot if you want to work on it, but I'd
rather prefer that you invite it to your guild instead of hosting your
own instance of it.**

### Get Python 3.6.5+
___
Any Python version higher or equal to 3.6.5 can be used to run the bot.

### Download or clone this repository and install the dependencies
___
After you got the source code of the bot, run

```$sql
python3 -m pip install -U -r requirements.txt
```

to install all the requirements the bot has.

### Setup PostgreSQL on your machine
___
You can download and install it from [here](https://www.postgresql.org/)

It is important since you'll need a PostgreSQL database to connect your bot to.
The newest version should be fine but you'll need at least PostgreSQL 9.5.

__Type the following code into the psql tool:__
```$sql
CREATE ROLE valepy WITH LOGIN PASSWORD 'your_password';
CREATE DATABASE valepy OWNER valepy;
CREATE EXTENSION pg_trgm;
```

### Run the bot
___
Now everything you need to do is to run the bot.
Get to the `config.example.py` file, rename it to `config.py` and fill out all necessary fields.
And the last step is to open your console and type
```python
# Windows:
py -3 launch.py

# Linux & macOS:
python3 launch.py
```
**Important:** If you want your bot's logs inside the console, use `py -3 launch.py --stream-log`.

**On the first bot start, it is necessary to add the `--init-db` flag. E.g: `python3 launch.py --init-db`.
This will create all database tables the bot depends on.**