lydia/README.md

# lydia
your friendly ai assistant. frontend for ollama.

> fair warning: lydia is very stupid

# Installation
- git clone repository
- install ollama from `https://ollama.ai/download`
- pull a model from ollama (i recommend gemma3n:e4b for laptops like mine (i7-10750h + rtx 3050ti laptop edition))
- copy config.example.toml to config.toml and edit it to have the model you selected, optionally set your name in [user]
- npm i
- node index.js
- enjoy

# Configuration
lydia is written to be easily configurable through a toml file which is easier to read and understand than json
## Assistant settings
- name = change the name you want the assistant to use for itself. changes it everywhere, including all placeholder text. default is "lydia"
- model = the ollama model you want lydia to use. default is "gemma3n:e4b"
- system_prompt = the system prompt you want lydia to use.
- assistantface = the default face you want lydia to have before waking up. default is "=w="

## Apperance settings
- facefont = the font you want lydia to use for her face kaomoji. default is "mono9". these are figlet fonts, like ".flf" files. you cannot use TTF or OTF font types. a good preview is here: https://www.askapache.com/online-tools/figlet-ascii/. you must have these fonts installed on your system, or install them depending on your operating system.

## User settings
- name = the name you want lydia to call you. default is "user"

## Advanced configuration
(I wouldn't touch this unless you know what you're doing)
- temperature = the temperature you want lydia to use. basically how random the model is. default is 0.8
- max_tokens = the max context tokens you want lydia to use. basically how far she can remember. default is 8192

## Runtime configuration
the prompt can be changed by running l!prompt <text> in the chatbox. this only applies for the current session, if you want a persistent change, you can edit the config file.

# Other stuff
by hitting escape you can tab out of the chatbox, here you can do cool things like:
- hit Q or CTRL+C to quit lydia (but why would you wanna do that anyway?)
- yea thats it