Local & Private
Powered by Ollama on your own machine. Nothing leaves your computer.
Your local coding agent. Powerful. Fast. Built for Linux.
ZEUS is a Claude-Code-style desktop agent powered by Ollama. Pick a project folder and a local model, and it reads, creates, edits and runs code, with every write or command gated by a permission engine. Nothing leaves your machine.
Phase 1 is a single agent that works on Ubuntu/Debian as an installable .deb.
Powered by Ollama on your own machine. Nothing leaves your computer.
Reads, creates, edits and runs code in your project folder with git and search tools.
Backend-enforced modes with inline approval cards. Every write or command is gated.
Tauri 2 app with a projects sidebar, chat timeline, Monaco diff viewer and terminal.
Picks a coding or reasoning model per prompt. Force one with /think or /code.
Conversations persist in SQLite and in .zeus/ folders, restored automatically.
A look inside the ZEUS desktop app. The slideshow advances every 2 seconds. Click the front card to zoom in.
Run Zeus from source. Start the FastAPI backend (127.0.0.1:8765, it creates backend/.venv on first run), then the UI at http://localhost:1420. You need Ollama installed separately; Zeus does not bundle it or any models.
scripts/run-backend.shcd frontend && npm install && npm run devFor the desktop shell, install the WebKit/GTK/Tauri system libraries with apt, then run:
frontend/node_modules/.bin/tauri devZeus currently ships as an installable .deb for Ubuntu/Debian. The package bundles its Python dependencies, so it installs offline. Download zeus_0.1.0_amd64.deb from the v0.1.0 release page and install it. Or build it yourself (needs network access once):
sudo apt install ./zeus_0.1.0_amd64.debpackaging/build-deb.sh
sudo apt install ./dist/zeus_0.1.0_amd64.debLaunch it with zeus or from the application menu. Uninstall with sudo apt remove zeus; your data stays in ~/.local/share/zeus unless you delete it.
Settings and history live in these locations:
<project>/.zeus/sessions/<id>.json one file per conversation
<project>/.zeus/project.json project info
~/.zeus/settings.json Ollama endpoint, default model and context, known projects
~/.local/share/zeus/zeus.db live SQLite storeThe project .zeus/.gitignore contains *, so history is never committed. Permissions are never read from .zeus/.
Reads allowed; all writes and commands denied.
Reads allowed; everything else asks.
Create/edit files and ordinary commands run inside the workspace. Delete, package install and git commit/push still ask.
Per-operation allow, ask or deny.
Always enforced: paths must stay inside the project, create_file never overwrites, and sudo, su, rm -rf / and pipe-to-shell are blocked. Commands run as your user in a normal shell and are not sandboxed.
Start the app from a terminal, and run the test suites when developing:
zeuscd backend && .venv/bin/python -m pytest
cd frontend && npm test && npm run buildIn a chat, start a prompt with /think or /code to force a reasoning or coding model. The agent's tools are list_files, read_file, search_files, create_file, edit_file, delete_file, run_command, git_status and git_diff.
No. Zeus talks only to your local Ollama server.
Any local Ollama model, discovered dynamically. The Models tab guides you through about 30 curated models with download and unload buttons, and the Usage tab shows ollama ps, GPU/VRAM, CPU/RAM and token counts.
Zeus falls back to parsing JSON or <function=...> tool calls.
Please report it on the GitHub issue tracker.
Phase 2 (not started) adds multi-agent orchestration. Memory, RAG and dashboards are out of scope for Phase 1.
ZEUS runs entirely on your machine and talks to Ollama to run local models. Ollama and the models are not bundled with ZEUS, so install them before you launch the app. This takes about five minutes.
The ZEUS .deb targets Ubuntu/Debian on amd64. You need sudo access to install packages.
Pick a model that fits your GPU VRAM or RAM. A 7B coding model needs roughly 4 to 5 GB; larger models need more.
Models are multi-gigabyte downloads and are stored on your machine, so leave free space for the ones you pull.
Run the official install script, or download the package from the Ollama website. It installs the ollama command and sets up a background service.
curl -fsSL https://ollama.com/install.sh | shThe service starts automatically. If you installed it manually, start the server yourself in a separate terminal.
ollama --version
systemctl status ollama
# if it is not running:
ollama serveZEUS needs at least one model. A good starting point is a 7B coding model. Optionally add a reasoning model so Auto mode can switch between the two.
ollama pull qwen2.5-coder:7b
# optional, for Auto mode:
ollama pull deepseek-r1:14bYour models should be listed, and the local server should answer on its default port.
ollama list
curl http://127.0.0.1:11434The second command should print Ollama is running.
Install the .deb from the Download tab and run zeus. The status in the sidebar should read Ollama connected. Then pick your model from the model menu.
Check systemctl status ollama (or run ollama serve) and make sure curl http://127.0.0.1:11434 answers. If Ollama runs on another host or port, change the Ollama endpoint in ~/.zeus/settings.json.
Run ollama list. If nothing is shown, pull a model with ollama pull <name>, then reopen the model menu in ZEUS.
The model is probably too large for your memory. Try a smaller one, or lower the context size in ZEUS. Run nvidia-smi on NVIDIA systems to check your GPU and VRAM.
See the Ollama project and the model library.
Before you install: ZEUS needs Ollama and at least one local model. They are not bundled with the app.
Set up Ollamasudo apt install ./zeus_0.1.0_amd64.debpackaging/build-deb.shscripts/run-backend.shYour download of zeus_0.1.0_amd64.deb should be starting. Follow these steps to run Zeus.
Use the Download button above if it has not started. Ollama is required and is not bundled, so set it up first.
Run this from the folder where the file was saved (usually Downloads).
cd ~/Downloads
sudo apt install ./zeus_0.1.0_amd64.debRun it from a terminal or open it from your application menu, then pick a project folder and a local model.
zeusYour data stays in ~/.local/share/zeus unless you delete it.
sudo apt remove zeusZeus does not bundle Ollama or any models; install Ollama separately. Other distributions are not packaged yet. After downloading, you can compute a checksum of your .deb and compare it with the value below. See the release page for notes, or report a problem.
sha256sum zeus_0.1.0_amd64.deb
0a44fe0c2867dfc462255c1e38790cf29ec7d397a3956afa333c6e9bad978f4c zeus_0.1.0_amd64.debPhase 2 brings multi-agent orchestration. Found a bug or have an idea? Contributions of every size are welcome. Star the project and join in.
Star on GitHubFound a bug? Report an issue