Features
A real chat client for Ollama, where every feature has its own animal to introduce it.
I'm Owl. I think before I answer: here is everything Lucania can do.
01 / Features
Open a block: the animal behind the feature introduces itself, then the details follow.
Filter by category
Your conversations stay on your machine. Lucania sends nothing, except to your own Ollama servers.
Answers are written while they are generated. Markdown rendering keeps lists, headings and code readable.
Think mode is switched on or off per conversation, with the Thinking button in the input area. The thinking time is shown in the conversation. It works with the models that offer it.
Each model has its own memory of facts, 500 characters at most per fact. They are given to it at the start of every conversation. You add, edit and delete them yourself, and you can let the model suggest facts to remember. Everything stays on your computer.
Create folders and drag your conversations into them. Pick the color and icon of each folder. Pin, rename or move a conversation. They are grouped by date, and deleting a folder keeps its conversations.
Pick your theme in Settings > Appearance. The choice is saved on the device.
The app is available in French and English. You pick the language in Settings > Appearance.
Add a connection “On this computer” or “On another machine”. Lucania tests the connection and detects the installed models. You can save several connections and switch them on one by one.
Lucania connects to Ollama on your machine or on a server you manage. Here is the outline of the guide in the repository. The addresses are examples: use the ones from your own tunnel.
Install WireGuard
Install the official client on both machines: the one running Lucania and the one running Ollama.
Create or import the tunnel
Create the configuration, or import the .conf file from the server administrator. Turn the tunnel on at both ends, then test with ping 10.0.0.2.
Open Ollama to the tunnel
By default, Ollama listens on 127.0.0.1. On Windows, create the system variable OLLAMA_HOST with the value 0.0.0.0, then restart Ollama. In the firewall, allow port 11434 only from the tunnel.
Add the connection
Check with curl http://10.0.0.2:11434/api/tags: a JSON reply lists the models. In Lucania, open Settings and add the server address as an Ollama connection.
For remote shutdown, run a small program on the remote machine that receives an HTTP request. In Settings > Remote shutdown, turn shutdown on for the connection, then enter the program URL, the HTTP method and the secret token. A “Shut down” button appears in the sidebar, and Lucania asks for confirmation.
02 / Under the hood
Ollama runs the models, memory keeps your facts, and the web stack uses no JavaScript framework.
The engine
Ollama runs the language models, on your machine or on a server you manage. Lucania is its chat interface: you install Ollama, download the models you like, and Lucania connects to it.
Memory
In Settings > Memory, you pick a model and manage its facts. They are given to it at the start of every conversation, and everything stays on your computer.
Facts are filed per model. A fact is 500 characters at most.
At the start of every conversation, the model receives its facts.
The model can suggest facts to remember from your conversations. You also add, edit and delete facts yourself.
Memory is switched on per model and per conversation.
The more facts the model remembers, the more its answers fit you: your projects, your tools, your preferences. Nothing is sent elsewhere to get there.
Memory builds on Obsidian: your facts stay readable notes, kept at home.
What the app repository contains, according to its README.
The base of the interface, server-rendered with the Node adapter.
All the browser code, with no JavaScript framework.
The styles, written as utility classes.
The interface components, built on Tailwind.
The local database of your conversations, in a file on your disk.
The shell of the desktop app for Windows.
The VPN tunnel you manage to reach a remote Ollama server.
Free, open source, for 64-bit Windows 10 and 11.