forked from pinks/eris
1
0
Fork 0
nyx/README.md

47 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2024-01-26 13:13:31 +00:00
# Nyx the Bot
Fork of Eris the Bot https://eris.lisq.eu
2023-11-06 17:38:41 +00:00
2023-09-03 19:06:20 +00:00
Telegram bot for generating images from text.
## Requirements
2024-01-26 13:13:31 +00:00
- [Deno](https://deno.land/) (for the bot server)
- [Stable Diffusion WebUI](https://github.com/AUTOMATIC1111/stable-diffusion-webui/) (for the worker that generates images)
2023-09-03 19:06:20 +00:00
## Options
You can put these in `.env` file or pass them as environment variables.
2023-09-10 18:56:17 +00:00
- `TG_BOT_TOKEN` - Telegram bot token. Get yours from [@BotFather](https://t.me/BotFather).
Required.
2023-10-18 21:11:25 +00:00
- `DENO_KV_PATH` - [Deno KV](https://deno.land/api?s=Deno.openKv&unstable) database file path. A
2024-01-26 13:13:31 +00:00
temporary file is used by default. Example: /opt/data/botdata.kv
2023-10-15 19:13:38 +00:00
- `LOG_LEVEL` - [Log level](https://deno.land/std@0.201.0/log/mod.ts?s=LogLevels). Default: `INFO`.
2023-09-03 19:06:20 +00:00
2023-10-18 21:11:25 +00:00
## Running
2023-09-22 02:59:22 +00:00
2023-10-23 00:39:01 +00:00
1. Start Eris: `deno task start`
2024-01-26 13:13:31 +00:00
2. Visit [Eris WebUI](http://localhost:8443/) and login via Telegram.
2023-10-23 00:39:01 +00:00
3. Promote yourself to admin in the Eris WebUI.
4. Start Stable Diffusion WebUI: `./webui.sh --api` (in SD WebUI directory)
5. Add a new worker in the Eris WebUI.
2023-10-15 19:13:38 +00:00
2024-01-26 13:13:31 +00:00
## This fork requires the use of webhooks.
1. You need a reverse Proxy and HTTPS certificate set up that proxies all requests from a domain on port 443 (e.g. nyx.akiru.de) to the backend of this bot (:8443).
2. Change the Webhook URL to your own one in /mod/bot.ts - There are also console log statements you can uncomment for troubleshooting.
3. Make sure the DNS and firewall are set up for the webhook to be reachable, because otherwise the bot fails to start.
2023-09-22 02:59:22 +00:00
## Codegen
2023-10-18 21:08:18 +00:00
The Stable Diffusion API types are auto-generated. To regenerate them, first start your SD WebUI
with `--nowebui --api`, and then run `deno task generate`
2023-10-18 21:11:39 +00:00
## Project structure
2024-01-26 13:13:31 +00:00
- `/api` - Eris API served at `http://localhost:8443/api/`.
2023-10-18 21:11:39 +00:00
- `/app` - Queue handling and other core processes.
- `/bot` - Handling bot commands and other updates from Telegram API.
2024-01-26 13:13:31 +00:00
- `/ui` - Eris WebUI frontend files served at `http://localhost:8443/`.
2023-10-18 21:11:39 +00:00
- `/util` - Utility functions shared by other parts.