Installing Topos

Prerequisites

• Python 3.12+
• macOS, Linux, or Windows

Installation

git clone https://github.com/yokoul/topos.git
cd topos

python3 -m venv .venv
source .venv/bin/activate    # macOS/Linux
# .venv\Scripts\activate     # Windows

pip install -e ".[dev]"

Verify Installation

python -m topos.main --simulate circle

Open http://localhost:7070 — the dashboard should display simulated moving tags.