your friendly ai assistant
Find a file
2025-08-02 21:44:32 +02:00
.gitignore initial commit 2025-07-18 12:53:00 +02:00
config.example.toml add some more configuration 2025-07-18 23:15:02 +02:00
lydia.js menu 2025-08-02 21:44:32 +02:00
package.json initial commit 2025-07-18 12:53:00 +02:00
README.md add some more configuration 2025-07-18 23:15:02 +02:00

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 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