Installation
Install the PoorMad agent core, desktop app, and portal on any platform.
This guide covers installing the PoorMad agent core on Linux, macOS, and Windows, plus the desktop app and the web portal.
Requirements
- Python 3.11 or newer (3.13 recommended).
- pip and a virtual environment tool (venv or uv).
- Network access to your chosen model provider (or a local model server).
- ~300 MB disk for the agent core; more for caches and skills.
Heads upOn systems with PEP 668 enforcement (recent Debian/Ubuntu/Fedora), install into a virtual environment or use
uv — do not pip install into the system Python.Install with pip
# create and activate a venv python3 -m venv ~/.venv/poormad source ~/.venv/poormad/bin/activate # install pip install --upgrade pip pip install poormad-agent
Install with uv (recommended)
uv venv
source .venv/bin/activate
uv pip install poormad-agent
Install script (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/Tayyaba22/poormad-agent/main/scripts/install.sh | bash
On Windows PowerShell use the equivalent install script:
iex (irm https://raw.githubusercontent.com/Tayyaba22/poormad-agent/main/scripts/install.ps1)
Desktop app
Download the native Windows (.exe) or macOS (.dmg) build from the releases page. The desktop app bundles its own runtime and connects to your local agent (or a remote gateway you configure).
Web portal
The web portal is a separate static front-end that talks to a running gateway. Host it yourself (see Self-Hosting) or use portal.xingabot.com.
Verify the install
poormad --version poormad --help
If both commands return output, you are ready for the Quickstart.