Installation

Installation

Agent Jo runs on Windows, macOS and Linux. It finds Python, sets up an isolated environment, and checks the download hasn't been tampered with.

Windows

1. Download the latest release and unzip it
2. Double-click install.bat

It needs Python 3.10+. If it's missing, the installer says so and links to it — tick "Add python.exe to PATH" when installing Python. It creates a self-contained environment and puts an Agent Jo shortcut on your desktop.

macOS

Double-click install.command.

It finds Python (offering Homebrew if you have it, never installing it for you), sets up an isolated environment, and checks the app loads.

Linux

./install.sh

Before changing anything

python install_agent_jo.py --check

Surveys the machine without changing anything.

First run

The app opens at http://127.0.0.1:8765 and asks how it should think:

• Anthropic (Claude) — best quality, paid per use. Get a key at platform.claude.com.
• Ollama — free and fully private, nothing leaves the computer. Install from ollama.com, then ollama pull qwen3.

Either can be changed later, and both can be used together — see Configuration.

Verifying the download

This runs commands on your machine, so check it's the real thing first:

pip install cryptography
python tools/sign.py --verify

See Security-and-Privacy for what this proves.

Where your data lives

Everything — conversations, memories, documents, settings — stays in .local_agent in your user folder. Nothing is uploaded. To remove the app, delete that folder.

This copy carries no personal data

It ships with no API key, no conversations and no memories.