olmon 0.1.0

A lightweight CLI to monitor Ollama models and usage

olmon

A lightweight CLI to monitor your Ollama models and usage in real time.

$ olmon watch
Watching http://localhost:11434 every 2s — Ctrl+C to stop

  🟢 Ollama v0.30.8 — 14 models installed, 2 running

  ┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━┓
  ┃ Name            ┃ Size   ┃ VRAM   ┃ Expires At   ┃
  ┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━┩
  │ llama3.2:latest │ 2.4 GB │ 2.4 GB │ 2026-06-23   │
  │ qwen2.5:7b      │ 4.4 GB │ 4.4 GB │ 2026-06-23   │
  └─────────────────┴────────┴────────┴──────────────┘

---

Features

• 🔄 Real-time dashboard — live auto-refreshing view of running models
• 📋 Model listing — browse all installed models with size, family, and quantization
• 🔍 Model inspection — full details on any installed model
• 🟢 Status indicators — green / blue / red at a glance
• ⚙️ Configurable — set your API host and refresh interval
• 🪶 Lightweight — minimal dependencies, works over SSH on headless servers

---

Requirements

• Python 3.13+
• Ollama installed and running

---

Installation

pip

pip install olmon

curl (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/glemiu6/olmon/master/scripts/install.sh | sh

From source

git clone https://github.com/glemiu6/olmon.git
cd olmon
uv pip install -e .

Windows

Native Windows binary is not currently supported. Use WSL and follow the Linux installation instructions.

Usage

olmon status               # quick health check
olmon models               # list all installed models
olmon models --sort size   # sort by size
olmon models --filter llama  # filter by name or family
olmon inspect llama3:latest  # full details on a model
olmon ps                   # show currently running models
olmon watch                # live auto-refreshing dashboard
olmon watch --interval 5   # refresh every 5 seconds

Global flags

olmon --host http://192.168.1.10:11434 status   # connect to remote Ollama
olmon --version                                  # print version

---

Status Indicators

Indicator	Meaning
🟢 Green	Models are loaded and running
🔵 Blue	Ollama is idle, no models loaded
🔴 Red	Ollama is offline or unreachable

---

Configuration

olmon init          # create default config file
olmon config show   # view current config

Config is stored at ~/.config/olmon/config.json:

{
  "host": "http://localhost:11434",
  "interval": 2,
  "no_color": false,
  "default_sort": "name"
}

---

Update & Uninstall

olmon update      # update to latest version
olmon uninstall   # remove olmon and config

---

Why olmon?

Most Ollama monitoring tools are GUI or system tray apps. olmon is built for:

• Headless Linux servers — no GUI required
• Remote monitoring — works over SSH
• Shell scripting — pipe-friendly with --json flag and exit codes
• DevOps workflows — integrate into scripts and cron jobs

---

Roadmap

See ROADMAP.md for the full plan.

---

Contributing

Contributions are welcome. Feel free to open an issue or submit a pull request.

---

License

MIT — see LICENSE for details.

---

Made with ❤️ by Vlad Digori