121 lines
4.2 KiB
Markdown
121 lines
4.2 KiB
Markdown
# Bars's TeleDiffusionBot
|
|
Open-source Telegram bot based on aiogram that uses
|
|
[AUTOMATIC1111 webui](https://github.com/AUTOMATIC1111/stable-diffusion-webui)
|
|
as backend.
|
|
|
|
# Features:
|
|
- Database hosting in telegram
|
|
- Prompts, negative prompts, multi models support and many other features from webui
|
|
- Saving and restoring prompts from pictures
|
|
- Many admins for bot
|
|
- Easy-to-edit code
|
|
- Bot hosting and StableDiffusion hosting can be separate
|
|
|
|
# Screenshots
|
|
|
|
|
|
|
|
...try it yourself!
|
|
|
|
# Setup instructions
|
|
### If using replit:
|
|
```commandline
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
pip3 install -r requirements.txt
|
|
```
|
|
Env variables setup is completed by adding them in menu (environment setup is described later)
|
|
|
|
### If using other hosting:
|
|
Setup bot as usually, environment setup is described later
|
|
|
|
### If hosting locally:
|
|
Create `.env` file in root of bot directory
|
|
|
|
### Important
|
|
Remember to run `/start` command in bot from admin account to set everything up after filling environment and running it.
|
|
|
|
## Environment
|
|
```env
|
|
TOKEN=
|
|
ADMIN=
|
|
DB_CHAT=
|
|
DB_PATH=
|
|
ENCRYPTION_KEY=
|
|
ARCHIVE_CHAT=
|
|
```
|
|
Add these variables to `.env` file or set up environment key-value on your hosting
|
|
|
|
## Env keys and values:
|
|
They should be in `KEY='VALUE'` format
|
|
### TOKEN
|
|
Bot token from BotFather
|
|
|
|
Bot `privacy` should be disabled.
|
|
```
|
|
Sequence within a BotFather chat:
|
|
You: /setprivacy
|
|
BotFather: Choose a bot to change group messages settings.
|
|
You: @your_name_bot
|
|
BotFather: 'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username.
|
|
'Disable' - your bot will receive all messages that people send to groups.
|
|
Current status is: ENABLED
|
|
You: Disable
|
|
BotFather: Success! The new status is: DISABLED. /help
|
|
```
|
|
[Source](https://stackoverflow.com/questions/38565952/how-to-receive-messages-in-group-chats-using-telegram-bot-api)
|
|
|
|
### ADMIN
|
|
Your id. To get it, use [@userinfobot](https://t.me/userinfobot). Send any message to this bot and copy your id.
|
|
|
|
### DB_CHAT
|
|
This is needed to host database in telegram. Create new group or use old group with databases. Invite your bot to this group and ensure it has access to messages or give admin rights to bot.
|
|
Invite @RawDataBot to your group:
|
|
|
|
|
|
|
|
Find this string and kick RawDataBot:
|
|
|
|
|
|
|
|
Add value to `DB_CHAT` variable. For me it is `-816497374`
|
|
|
|
### DB_PATH
|
|
Path to folder where `db` and `dbmeta` are stored. `dbmeta` is file, that you need to copy when moving to other hosting
|
|
to restore database. Path can be `.` to store in same folder. For me now it is `/home/barstiger/db/TeleDiffusionBot`
|
|
|
|
### ENCRYPTION_KEY
|
|
Password to encrypt some database fields. Do not share it.
|
|
|
|
### ARCHIVE_CHAT
|
|
Images, generated using bot will be sent to this group by id. Bot should be added to group. This is optional.
|
|
|
|
## Starting bot
|
|
Type `/start` in new bot PM to set up everything.
|
|
|
|
If you see errors or warnings (such as `🔄️ Bot database synchronised because of restart.
|
|
If you tried to run a command, run it again`), run `/start` command again and again until you
|
|
will receive expected output (some messages with `👋 Hello, YOUR NAME....` and `✅` boxes). It is needed to
|
|
mark up database and create all tables, restart bot and sync database.
|
|
|
|
After that, install [AUTOMATIC1111 webui](https://github.com/AUTOMATIC1111/stable-diffusion-webui)
|
|
and run it with `--api` argument (for me arguments are `--no-half --xformers --api --listen` to properly work with newer SD models and work in local network).
|
|
Make sure that `Add model name to generation information` is enabled in settings!
|
|
|
|
|
|
|
|
Run `/setendpoint http://endpoint_address:port`. For me now it is `http://192.168.50.30:7860`, WITHOUT BACKSLASH at the end
|
|
|
|
Bot is ready to use!
|
|
|
|
### If something doesnt work, check subsequence of actions:
|
|
|
|
- clone repo
|
|
- cd to repo
|
|
- create python venv
|
|
- install requirements
|
|
- create `.env` file and fill it
|
|
- run `python main.py`
|
|
- `/start` 2-3 times to bot private messages (until you see expected output)
|
|
- `/setendpoint` command with proper args
|