Metadata-Version: 2.4
Name: olmon
Version: 0.1.0
Summary: A lightweight CLI to monitor Ollama models and usage
Author-email: Vlad Digori <digorivlad59@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/glemiu6/olmon
Project-URL: Repository, https://github.com/glemiu6/olmon
Project-URL: Bug Tracker, https://github.com/glemiu6/olmon/issues
Keywords: ollama,monitor,cli,llm,devops,developer-tools
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mypy>=2.1.0
Requires-Dist: platformdirs>=4.10.0
Requires-Dist: rich>=15.0.0
Dynamic: license-file

# 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](https://ollama.com) installed and running

---

## Installation

### pip

```bash
pip install olmon
```

### curl (Linux / macOS)

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

### From source

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

Native Windows binary is not currently supported.
Use [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) and follow the Linux installation instructions.
---

## Usage

```bash
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

```bash
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

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

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

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

---

## Update & Uninstall

```bash
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](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](LICENSE) for details.

---

Made with ❤️ by [Vlad Digori](https://github.com/glemiu6)
