Installation

Requirements

• Python 3.10 or later
• A working Juju installation (~/.local/share/juju/ populated)

JujuMate reads your Juju credentials automatically from ~/.local/share/juju/ — the same directory used by the juju CLI. No additional configuration is needed.

---

Install

snap (recommended)uvpipxpip

sudo snap install jujumate

The snap package bundles all dependencies — no Python installation required.

uv tool install jujumate

uv is the fastest way to install and run Python tools in isolated environments.

pipx install jujumate

pip install jujumate

---

Run

jujumate

On first launch JujuMate connects to your current Juju controller and auto-selects your current model.

---

Install from source

git clone https://github.com/Abuelodelanada/jujumate.git
cd jujumate
uv sync
uv run jujumate

---

Upgrade

snapuvpipx

sudo snap refresh jujumate

uv tool upgrade jujumate

pipx upgrade jujumate