# how to run ts bullshit

two parts: `bot.py` talks to discord, `main.py` (ollama) or `gemini.py` (gemini api) is the brain. 
`main.py` is stateless so it can live on another machine / colab and talk to `bot.py` through a websocket or tunnel, you never have to upload your files anywhere sketchy

# installing
pick your distro. all of them use a venv because python doesn't let you `pip install` system wide anymore

### ubuntu
```console
$ sudo apt install python3 python3-venv curl zstd
$ curl -fsSL https://ollama.com/install.sh | sh
```
### arch
```console
$ sudo pacman -S python ollama
#ollama-cuda or ollama-rocm if you have a gpu
```
### gentoo
```console
$ sudo emerge --ask dev-lang/python sci-ml/ollama
#sci-ml/ollama is ~amd64, so you need to keyword it first
$ echo "sci-ml/ollama ~amd64" | sudo tee /etc/portage/package.accept_keywords/ollama
#sci-ml/ollama-bin if you don't wanna compile it
```
(skip the ollama part if you're using the gemini api)

then your python dependencies are
```console
$ python3 -m venv venv
$ source venv/bin/activate
$ pip install ollama websockets discord.py
#and this one only if you're using the gemini api
$ pip install google-genai
```

# once you install your dependencies
you need ollama running (not needed for gemini)
```console
#ollama needs to be serving, the packages above already ship a service
$ sudo systemctl enable --now ollama #ubuntu / arch / gentoo systemd
$ sudo rc-update add ollama default && sudo rc-service ollama start #gentoo openrc
#or just run it by hand
$ ollama serve &
$ ollama pull <your model>
$ ollama pull <your embedding model>
#those two are in main.py
#test it with
$ ollama run <your model>
```
if that runs fine (or you have a gemini key) then you can
- go to the discord developer portal and turn on **message content intent** and **server members intent** for your bot or it won't start
- add the bot to your server
- run the wizard, it writes all the config files for you
```console
$ python3 setup_wizard.py
```
- edit your system prompt in `./files/config/system_prompt.txt` (it makes a placeholder the first time bot.py runs)
- optional: `./config/params.json` has the ollama options (temperature and stuff), without it ollama just uses its defaults
- run the brain first, then the bot
```console
$ python3 main.py #or gemini.py
$ python3 bot.py
```
she only reads `general` and `announcements`, and every dm gets its own memory in `./files/log/dm/` so it never leaks into the server

# fallback
if you're using gemini you can have a local ollama `main.py` take over when gemini says you're out of quota. the wizard asks about it (it's the third line of `./files/config/connection.txt`), it needs to run on another port so run it as
```console
$ PORT=8766 python3 main.py
```
the bot goes back to trying gemini after an hour. if there's no fallback (or it's down) she just says "usage limit reached, see you in a month"

# admin
`admin.py` is the admin panel, it only edits files on the box so nobody on discord can touch it. the bot re-reads everything on every message, no restart needed
```console
$ python3 admin.py list
$ python3 admin.py edit <blocked|prompt|settings|reactions|params> #opens $EDITOR, vim if you don't have one
$ python3 admin.py block <user id>
$ python3 admin.py unblock <user id>
```
`reactions.json` is where the stickers / emojis / media she can send live, the bot adds new ones with an empty description and you fill them in. media with no description never gets offered

# colab
if your pc can't run the model you can host `main.py` on colab, run `setup_wizard.py` on both sides and say yes to the colab question
```console
#on colab
$ python3 colab_setup.py
```
it prints a wss:// address and a token, paste those into the wizard on the bot.py side. the address changes every time you restart the notebook

# IF IT FAILS
- check `./files/log/errorlog.txt`
- `bad auth token` means the token in `./files/config/connection.txt` isn't the one main.py has in `./config/auth_token.txt`
- on colab main.py logs to `main.log` next to colab_setup.py

# have fun