Repository navigation
Releases: cyryllo/LamaDeck
Release list
LamaDeck 1.0.1
A small update after 1.0, mostly documentation.
New: user guide
A guide with a screenshot of every screen, explaining what each feature does and how to install or turn it on. It covers the services, models, chat with web search, the tray, where your data is kept and common problems.
- On the web: https://cyryllo.github.io/LamaDeck/guide/ (Polish: https://cyryllo.github.io/LamaDeck/pl/guide/)
- In the repository: docs/GUIDE.md · docs/PRZEWODNIK.md
Fixes
- Settings → Versions and updates: SearXNG's version now shows right away, without pressing "Check for updates" first.
- Dashboard: no VRAM size next to "this computer". It was misleading on APUs and can't be read for remote hosts anyway. Detailed memory figures are on the Ollama hosts screen.
- New screenshots in the README.
Files
lamadeck_1.0.1_all.deb: Debian 13, Ubuntu 24.04 and newer (also via the APT repository:sudo apt upgrade)LamaDeck-1.0.1-x86_64.AppImage: any x86_64 distribution
LamaDeck 1.0.0
LamaDeck is complete. This release adds web search to the built-in chat, and from now on the project gets bug fixes only.
Web search in the chat
- A globe button next to the paperclip turns web search on. You only see it once a results source is chosen in Settings.
- How it works:
- the model writes 1–3 search queries;
- the app searches and reads up to 5 pages;
- it picks the passages that match your question;
- the answer cites them as [1], [2]…, with clickable sources below.
- Works with any model, no tool calling needed. Sources are kept in saved conversations and in the Markdown export.
- Results source (Settings → Chat):
- SearXNG on this computer: installed with one click for your user, no root, no Docker, no account. Start, stop, autostart, update and remove from the same place.
- SearXNG at another address: your own server.
- Ollama's web search: needs a free ollama.com account and an API key.
- Off by default: queries go to the internet only when you turn it on.
Other changes
- Models: "Community models" checkbox. It also finds models other authors published on ollama.com (e.g.
jobautomation/OpenEuroLLM-Polish). It's off by default, because Ollama doesn't review them. Pasting an ollama.com link opens the model's variants. - Hosts: real RAM use on APUs. The part of a model kept in system memory shared with the GPU is now counted, shown as "Ollama X GB + APU Y GB".
- Hosts: this computer can no longer be removed from the list.
- Chat: a copy icon above code blocks. The regenerate/edit icons no longer disappear now and then after an answer.
- Settings: web search lives in the Chat card.
Install
- Debian / Ubuntu: the APT repository (see the README) or the
.debbelow. The.debadds the repository, so updates come withapt upgrade. - Any distribution: the AppImage below.
chmod +xit and run; it offers to add itself to the menu. - Project page: https://cyryllo.github.io/LamaDeck/
Files
lamadeck_1.0.0_all.deb: Debian 13, Ubuntu 24.04 and newerLamaDeck-1.0.0-x86_64.AppImage: any x86_64 distribution (glibc 2.34+)
LamaDeck 0.9.12 — APT repository and AppImage
New ways to install
Debian / Ubuntu: APT repository (recommended). Add it once, and LamaDeck updates together with the rest of your system:
sudo curl -fsSLo /usr/share/keyrings/lamadeck-archive-keyring.gpg \
https://cyryllo.github.io/LamaDeck/apt/lamadeck-archive-keyring.gpg
sudo curl -fsSLo /etc/apt/sources.list.d/lamadeck.sources \
https://cyryllo.github.io/LamaDeck/apt/lamadeck.sources
sudo apt update
sudo apt install lamadeck
The .deb attached below adds the same repository, so sudo apt install ./lamadeck_0.9.12_all.deb also gets you updates through apt from now on. It replaces the old ollama-manager package.
Any distribution: AppImage. One file with everything inside (Python, Qt, the app), for Fedora, Arch, openSUSE and others:
chmod +x LamaDeck-0.9.12-x86_64.AppImage
./LamaDeck-0.9.12-x86_64.AppImage
- On the first start it offers to add itself to the applications menu. There is also a switch for this in Settings.
- The menu entry and "start after login" follow the file if you move it.
- Needs glibc 2.34 or newer (Ubuntu 22.04, Debian 12, Fedora 35 and later).
Project page: https://cyryllo.github.io/LamaDeck/ (English and Polish), with screenshots and install instructions.
Changes
- Chat: rounded message bubbles, with more room next to the scrollbar.
- Chat: code blocks on Ubuntu 24.04 (Qt older than 6.7) no longer crash the chat, and
->or<!--show as plain characters there too. - Optional Open WebUI packages (ffmpeg, pandoc, zstd): on systems without apt, the app lists what to install instead of trying apt-get.
install.shinstalls PyQt6 below 6.12, because the new PyQt6 6.12 from pip no longer includes the QtPdf module needed for PDF attachments.
Upgrading from Ollama Manager
LamaDeck was called "Ollama Manager" up to version 0.9. Installing it in any way keeps your settings, conversations and router configuration. The app moves them on its first start.
Files
lamadeck_0.9.12_all.deb: Debian 13, Ubuntu 24.04 and newerLamaDeck-0.9.12-x86_64.AppImage: any x86_64 distribution
LamaDeck 0.9.9 — formerly Ollama Manager
The app has a new name: LamaDeck. "Ollama Manager" could suggest an official Ollama app — LamaDeck is an independent control panel for your local AI stack (Ollama, LiteLLM, Open WebUI and a built-in chat), not affiliated with Ollama. The repository moved to cyryllo/LamaDeck; old links and clones keep working.
Updating keeps everything. On its first start LamaDeck moves your settings (hosts, aliases, language), saved conversations, the LiteLLM router config and the start-after-login entry from the old "Ollama Manager" locations. install.sh replaces the old install by itself, and the .deb package replaces the old ollama-manager package.
✨ New in the chat
- Conversations are saved automatically after every answer — one file each in
~/.local/share/LamaDeck/czaty/, only on your computer. A list on the left opens and searches them (titles and content); right-click to rename, export to Markdown or delete (also double-click / F2 to rename, Delete to delete) - Links in a question: paste a link and the app downloads the page itself — no account — and adds its text to the question (PDF links too; long pages go through excerpt search)
- Context usage: "4 051 / 65 536 (6%)" for the current conversation, with a warning from 80% — before the model silently starts forgetting the beginning
- Thinking on/off for models that reason first (qwen3, gemma4…): off, a simple question takes a fraction of a second instead of 15 s (measured on gemma4); reasoning can still be shown when on
- Small icons in message headers: copy an answer, regenerate the last answer with the model selected right now (handy for comparing models), edit the last question
- Model tags under the model picker: in memory / on disk, pictures, thinking, tools
- A more compact right panel and a wider conversation list
- The tray icon menu's "Open chat" opens the built-in chat
🔧 Install / update
.deb: downloadlamadeck_0.9.9_all.debfrom the Assets below and runsudo apt install ./lamadeck_0.9.9_all.deb— it replacesollama-managerautomatically. Run it aslamadeckor from the menu (Utilities).install.sh:git clone https://github.com/cyryllo/LamaDeck.git && cd LamaDeck && ./install.sh. If the app is already installed from a.deb, it now offers to remove that first, so you don't end up with two copies.
What's next
Before 1.0: an own APT repository (install and update with apt) and an AppImage for other distributions. 1.1 brings web search in the chat. After that: bug fixes only.
Ollama Manager 0.9.0
The last feature release before 1.0. The built-in chat can now read documents — PDF, Word, Excel, PowerPoint, LibreOffice and EPUB — with nothing beyond Ollama, Python and Qt.
✨ New
- Documents in the chat: attach
.pdf,.docx,.xlsx,.pptx,.odt,.ods,.odpor.epub- the text is extracted in the background: tables and sheets as
a; b; crows, numbered slides and PDF pages, EPUB chapters in reading order - small documents are sent whole; large ones (100 KB – 20 MB of text) go through excerpt search with an embedding model in Ollama, and the answer shows which lines the excerpts came from
- scanned PDFs without a text layer get a hint (paste a screenshot for a vision model, e.g. glm-ocr); old
.doc/.xls/.ppt/.rtffiles get a "save as" hint
- the text is extracted in the background: tables and sheets as
- Estimated remaining time on the attachment while a large file is being indexed, based on the speed measured on your computer
🐛 Fixes
- Chat statistics card: descriptions wrap instead of being cut off by the values
📦 Packaging
- PDF reading uses Qt's own QtPdf module: it's already in the pip PyQt6; the
.debnow depends onpython3-pyqt6.qtpdf, andinstall.shoffers it when PyQt6 comes from apt without it
📖 Docs
- New README screenshots (dashboard, chat, tray panel) in English and Polish
What's next
0.9.0 is the near-final version. Before 1.0 only a few chat additions are planned (automatic saving of conversations, a context-usage indicator, a "no thinking" switch, regenerate/edit the last question, copying and exporting answers). After 1.0 the project switches to bug fixes only.
Installation
Choose one of the two ways — both work on Debian / Ubuntu / KDE neon and other Debian-based systems.
Option 1 — the .deb package (easiest)
Download ollama-manager_0.9.0_all.deb from the Assets below and install it:
sudo apt install ./ollama-manager_0.9.0_all.debapt pulls in all dependencies (PyQt6 with QtSvg and QtPdf, requests, pkexec, curl). The app appears in the menu under Utilities and can also be started with ollama-manager. Updating = installing a newer .deb the same way; removing = sudo apt remove ollama-manager.
Option 2 — install.sh (no root, installs into your home folder)
git clone https://github.com/cyryllo/Ollama-manager.git
cd Ollama-manager
git checkout v0.9.0
./install.shInstalls PyQt6 and requests with pip for your user, copies the app to ~/.local/share/ollama-manager and adds a menu entry. Run it again to update (it detects the installed version and asks); remove with ./install.sh --uninstall.
Use only one of the two methods at a time — if you switch, uninstall the other one first, otherwise you'll get two menu entries.
After the first start, the app installs Ollama, the LiteLLM router and Open WebUI itself with one click each, if you want them.
Ollama Manager 0.8.6
The biggest update since the redesign: a built-in chat with speed stats, file attachments and search in large text files, plus a system tray panel, desktop notifications and a fix for random crashes.
✨ New
Chat (new screen)
- Chat with any model on any host, straight from Ollama — no Open WebUI or router needed
- Answers stream in with formatting (code blocks, lists, tables), a Copy code link above every code block, and a Stop button
- Speed stats for every answer, measured by Ollama: generation and prompt processing in tokens/s, token counts, model loading time, total time
- A notice with a seconds counter while the model is being loaded into memory (the first question can take a while)
- Optional view of the model's reasoning (thinking models such as qwen3)
- Attachments: 📎 button, drag & drop, or paste a screenshot with Ctrl+V
- pictures go to models that can see images (vision); a model without vision is blocked with a hint
- text files (code, .txt, .md, .csv, .json…) are added to the message
- Large text files (100 KB – 20 MB) are searched, not pasted: the file is split into excerpts and indexed with an embedding model in Ollama. Each question gets the best-matching excerpts, and the answer shows which lines they came from. Nothing beyond Ollama is needed, and nothing is written to disk
- The embedding model can be chosen in Settings → Chat. Without one, a button there downloads the recommended multilingual
nomic-embed-text-v2-moe - Only models that can chat are listed; OCR models appear only when a picture is attached
System tray (optional, off by default)
- Tray panel: the installed services with on/off switches, CPU / VRAM / RAM, models in memory, Open chat, plus a small WebUI button while Open WebUI is running
- Closing the window hides it to the tray; optional start after login; only one copy of the program runs at a time
- Works on Wayland (KDE Plasma): the panel opens next to the tray without flicker
Other
- Desktop notifications when a model download, installation, update or backup finishes while the window is in the background
- MoE filter in model search — handy for APUs and computers without a strong GPU
- RAM usage on the Ollama hosts screen
- Services that are not installed are hidden from the sidebar, Settings and the tray panel (installation stays on the dashboard)
- Router: the model list is now a table; a separator in the sidebar
🐛 Fixes
- Random crash ("the program closed by itself"): a worker thread could be destroyed while still finishing. All background threads are now kept alive until they really end
- Sidebar no longer jumps back to the dashboard when the window regains focus (Alt+Tab, Settings from the tray)
- Dark lines under updated values with fractional display scaling
- Strategy cards on the Router screen no longer get squeezed in longer translations
⚙️ Changed
- "Apply recommended values" in Settings now sets
OLLAMA_MAX_LOADED_MODELS=2, so the chat model and the embedding model can stay in memory together
Install / update
./install.shOllama Manager 0.6.8 — a whole new interface
The app has been rebuilt from the ground up: a dark Breeze look, a sidebar with seven
screens, bundled fonts (Inter + JetBrains Mono) and a new llama logo.
New screens
- Dashboard — one switch for all services (Ollama, LiteLLM router, Open WebUI), a card
per service with its own on/off switch or an "Install" button, loaded models, GPU load,
and live CPU / VRAM / RAM / network gauges. - Ollama hosts — every host on your LAN at a glance: online/offline, Ollama version,
response time, VRAM use and the models on each host (a RAM icon shows which ones are
loaded). Add a host by typing just its address. - LiteLLM router — a live route diagram, model aliases (fixed names like
chator
codefor a model on chosen hosts), a choice of what to do when a model is on several
hosts (take turns / least busy / fastest), an optional API key, and ready-made settings
for Continue.dev and Open WebUI. - Models — models from all hosts as tiles with filters (chat, code, embedding,
vision); Load / Unload, Copy to host, delete from one or all hosts. The Ollama +
Hugging Face search stays, and downloads show speed and can be cancelled. - Open WebUI — start / restart / stop, port, open the browser after start, require
login, and a one-click backup of all chats (ZIP). - Log — messages from Ollama, LiteLLM, Open WebUI and the app in one place, with a
plain explanation of common errors; save to file. - Settings — language, autostart and update checks for all three services, and
Ollama environment variables, each with a short description.
Other changes
- The installer can give your account read access to the Ollama service log
(one question, needssudo; takes effect after logging in again). - The "Help" tab and the "Manage servers" dialog are gone — descriptions now live in
Settings, hosts are managed on the Ollama hosts screen.
Upgrading
./install.sh(it updates an existing install), or build a package with./build-deb.sh.- The
.debpackage now also depends onpython3-pyqt6.qtsvg. - The window is always dark, regardless of the KDE color scheme.
Ollama Manager 0.6.4
New
- Open WebUI connection guide. A new "Connection for Open WebUI..." button in the
Model aggregator tab shows exactly how to add the LiteLLM aggregator in Open WebUI
(Admin Panel → Settings → Connections → OpenAI API → "+"). It includes the address for
this computer (http://localhost:4000/v1) and its LAN address (for WebUI running on
another machine), with copy buttons. You only need to add one connection: WebUI then
sees models from every host on the server list. When you add a new host, click
"Restart" next to LiteLLM and refresh the WebUI page. - Choose which models LiteLLM serves. Every model/host row in Models in the
aggregator now has a checkbox. Unchecked models are left out of the LiteLLM config
and the generated Continue config. Your choice is remembered after a refresh or
restart. New models are on by default. The choice applies per host, so the same model
can be served from one machine only (e.g. BC-250). Changes take effect after
"Restart".
Removed
- The Unsloth Studio connection dialog.
Notes
- Earlier versions never connected Open WebUI to LiteLLM. WebUI only saw the local
Ollama, so models from other hosts didn't show up there. The app shows instructions
instead of writing the setting itself: Open WebUI keeps connections in its own
database and ignores environment variables once a value is saved there.
Install / update: ./install.sh or build a package with ./build-deb.sh.
Ollama Manager v0.6.2
New
- Restrict LAN access by IP (
IPAddressAllow): new field in the Advanced tab, right belowOLLAMA_HOST.
Enter the hosts allowed to connect, e.g.localhost 192.168.8.20 192.168.8.0/24.- Empty field = the whole LAN can connect (same as before).
- With a list set, other private addresses (10.x, 172.16–31.x, 192.168.x) are blocked by systemd
(IPAddressDeny), while internet access stays open, so model downloads keep working. - Entries are validated before saving (IP, CIDR subnet, or
localhost/link-local/multicast/any). ⚠️ The filter applies in both directions. If your DNS server is a router on the LAN (e.g.192.168.8.1),
add it to the list.- Only makes sense with
OLLAMA_HOSTenabled.
- Context length presets:
OLLAMA_CONTEXT_LENGTHis now a drop-down with standard sizes:
default, 4k, 8k, 16k, 32k, 64k, 128k.- You can still type any custom number, and non-standard values already in
override.confare kept. - Values that aren't a plain number are rejected before saving.
- You can still type any custom number, and non-standard values already in
Other
- Translations updated for all UI languages (EN, DE, ES, FR, IT, PT).
- README updated with the new
IPAddressAllowoption.
v0.6.0
One model search for two sources
- The Download new model card is now a single search across the official Ollama library and Hugging Face (GGUF). Every result shows its Source; Ollama results are always listed first. Pick a model to see all its variants with real file sizes, then Download.
- Pasting a Hugging Face link jumps straight to that repo's variants; an exact name with a tag (e.g.
llama3.2:3b) downloads without searching. - Removed the recommended-models list, the Size/Quantization fields and the separate Hugging Face dialog. MLX-only and cloud-only models are skipped.
- The installed models table has a Source column (Ollama / Hugging Face).
Memory
- New RAM and VRAM + RAM tiles in the stats bar. For the local Ollama, RAM is measured from its processes (including memory-mapped model files); loaded models show their split, e.g.
20.0 GB VRAM + 16.0 GB RAM. - The memory estimate for a download now uses the real file size.
LiteLLM aggregator
- Fixed: LiteLLM 1.105+ refused to start without a master key (fresh installs). New optional Require API key setting, off by default.
- Connection details for Unsloth Studio (it has no config file).
Fixes
- Ollama search broke after ollama.com changed its page layout. Fixed, and the app now reports an error instead of silently showing only Hugging Face results.
- Hugging Face repos that ship the same model both whole and split no longer show double the size.
