Skip to content
Zenus logo Zenus

Getting Started

Requirements

  • Linux (Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch, or any modern distro)
  • Python 3.10 or higher
  • At least one LLM backend — local (Ollama) or cloud (Anthropic, OpenAI, DeepSeek)

Installation

pip (fastest)

pip install zenus-cli

This installs the zenus CLI and zenus-tui dashboard.

snap install --classic zenus

From source

git clone https://github.com/Guillhermm/zenus.git
cd zenus
./install.sh
source ~/.bashrc

The installer creates a virtual environment, installs all packages, and guides you through choosing an LLM backend.

Choose an LLM backend

Edit ~/.zenus/config.yaml and set your provider:

llm:
  provider: anthropic          # anthropic | openai | deepseek | ollama
  model: claude-sonnet-4-6
  api_key: ""                  # or set ANTHROPIC_API_KEY in your environment
ProviderCostNotes
Ollama (local)Free4–16 GB RAM. Full privacy. ollama pull llama3.3
Anthropic~$0.003/cmdBest reasoning. claude-sonnet-4-6 recommended.
DeepSeek~$0.0003/cmdStrong performance at very low cost.
OpenAI~$0.001/cmdgpt-4o and gpt-4.1 supported.

First commands

Single command

zenus "show me the 5 largest files in my home directory"

Interactive shell

zenus

zenus > organize my downloads by file type
zenus > show disk usage for this machine
zenus > exit

Dry run — preview without executing

zenus --dry-run "delete all .log files older than 30 days"

Undo the last action

zenus rollback
zenus rollback 3      # undo last 3 actions

View history

zenus history
zenus history --failures

TUI dashboard

zenus-tui

Next steps