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"

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