Zeus

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.

Built for local-first coding

Phase 1 is a single agent that works on Ubuntu/Debian as an installable .deb.

Local & Private

Powered by Ollama on your own machine. Nothing leaves your computer.

Tool-Using Agent

Reads, creates, edits and runs code in your project folder with git and search tools.

Permission Engine

Backend-enforced modes with inline approval cards. Every write or command is gated.

Native Desktop App

Tauri 2 app with a projects sidebar, chat timeline, Monaco diff viewer and terminal.

Auto Model Mode

Picks a coding or reasoning model per prompt. Force one with /think or /code.

Session Memory

Conversations persist in SQLite and in .zeus/ folders, restored automatically.

See Zeus in Action

Getting Started

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.sh
cd frontend && npm install && npm run dev

For the desktop shell, install the WebKit/GTK/Tauri system libraries with apt, then run:

frontend/node_modules/.bin/tauri dev

Installation

Zeus 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.deb
packaging/build-deb.sh
sudo apt install ./dist/zeus_0.1.0_amd64.deb

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

Configuration

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 store

The project .zeus/.gitignore contains *, so history is never committed. Permissions are never read from .zeus/.

Permissions

Read only

Reads allowed; all writes and commands denied.

Approval (default)

Reads allowed; everything else asks.

Trusted

Create/edit files and ordinary commands run inside the workspace. Delete, package install and git commit/push still ask.

Custom

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.

CLI Usage

Start the app from a terminal, and run the test suites when developing:

zeus
cd backend && .venv/bin/python -m pytest
cd frontend && npm test && npm run build

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

FAQ

Does my code leave my machine?

No. Zeus talks only to your local Ollama server.

Which models can I use?

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.

What about weaker models that print tool calls as text?

Zeus falls back to parsing JSON or <function=...> tool calls.

Found a bug or have a problem?

Please report it on the GitHub issue tracker.

What is on the roadmap?

Phase 2 (not started) adds multi-agent orchestration. Memory, RAG and dashboards are out of scope for Phase 1.

Zeus is open source

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

Found a bug? Report an issue