1
0
Fork 0
mirror of https://github.com/myned/modufur.git synced 2024-11-01 13:02:38 +00:00
modufur/README.md

2.8 KiB

Modufur

An experimental Hikari Discord bot for reverse image searching using SauceNAO & Kheina

ko-fi

Prerequisites

A Unix-based operating system is used for the following commands
WSL can be used to run Linux on Windows, but is not required to run the bot

Requirements

Git
Python 3.10+
Poetry

Installing

Clone this repository

git clone https://github.com/Myned/Modufur.git

Go to the project folder

cd Modufur

Create a virtual environment and install dependencies

poetry install

Usage

Go to the project folder

cd Modufur

Run with optimizations

poetry run python -OO run.py

Setup

Run to create config.toml
The file will automatically generate if it does not exist

guilds = [] # guild IDs to register commands, empty for global
master = 0 # guild ID to register owner commands
client = 0 # bot application ID
token = "" # bot token
activity = "" # bot status
saucenao = "" # saucenao token
e621 = "" # e621 token

Updating

Go to the project folder

cd Modufur

Pull changes from the repository

git pull

Remove the virtual environment folder (necessary because of git dependencies)

rm -rf .venv

Reinstall and update the virtual environment

poetry update

Uninstalling

Remove the project folder

rm -rf Modufur

Contributing

  1. Fork this repository on GitHub
  2. Make changes to the code
  3. Format the code with Black inside the project folder
    poetry run python black .
    
  4. Commit the changes to the fork
  5. Create a pull request from the fork

FAQ

What happened to the public bot?

My Discord account was deleted, so a new bot had to be created.

Although public, I do not wish for it to be excessively used due to API quotas.

Why can't I send explicit images to the bot?

Discord currently has no way to disable scanning content for bots.
You can send links uploaded elsewhere instead.

Credits

hikari
hikari-lightbulb
hikari-miru
pysaucenao