Radioshaq
Radioshaq was inspired by living close to the french / spanish border and mountains.
Core trick
A Gemini orchestrator routes each radio task to subagents, with a judge that gates actions against a whitelist before transmission.
Description
Radioshaq was inspired by living close to the french / spanish border and mountains. based on my experience , radio operations need this , it's that simple.
RadioShaq brings citizen radio operations into the 21st century, it's the first and only opensource system and citizen system that does simple things for example multiband relay , message store and send , etc. everything is compliant by default , whitelist based , gemini powered.
So what does it actually do ?
the gemini-powered orchestrator is supported by a judge and deploys subagents and subjudges for each task . for exa, mple "radio chat" , for example "relay" , for example "store location information", and respond with coordination and other compliance according to stored and persistent data.
README excerpt
# RadioShaq Monorepo for **RadioShaq**: ham radio AI orchestration and remote SDR reception. One main app (single PyPI package); Python is managed with [uv](https://github.com/astral-sh/uv). **What this repo does** - **RadioShaq** — AI-powered orchestrator for ham radio, emergency comms, and field–HQ coordination. FastAPI backend, React (Vite) web UI, Postgres + Alembic, optional real radios and SDR. The **remote receiver** (SDR listen-only station) is bundled; run with `radioshaq run-receiver`. --- ## Prerequisites - **Python 3.11+** and **[uv](https://github.com/astral-sh/uv)** - **PostgreSQL** — Easiest is Docker on port 5434 (avoids conflict with local 5432). Or use an existing server and set `RADIOSHAQ_DATABASE__POSTGRES_URL`. - **Optional:** Node.js + PM2 for running the API under PM2; Docker for Postgres. --- ## Launch (choose one path) All steps below assume you are in **radioshaq/** unless noted. ### Option A: Interactive setup (recommended first time) Guided prompts for mode, database (Docker or URL), JWT, LLM, and optional radio/memory. Writes `.env` and `config.yaml`, can start Docker and run migrations. ```bash cd radioshaq uv sync --all-extras radioshaq setup # Minimal: radioshaq setup --quick # CI: radioshaq setup --no-input --mode field ``` Then start the API (see Option D or manual steps below). ### Option B: Full automated setup (Windows / Linux) One script: install deps, create config, start Docker Postgres (port 5434), run migrations, in