Echohub

Echohub is a local-first telemetry deck built around Echopoint data. One Python engine owns fetching, caching, normalization and analytics; two renderers consume the same DashboardState:

• Desktop app - native Qt (PySide6) app: compact, with its own chrome. The default echohub command.
• TUI - keyboard-first true-color terminal interface.

Network contract

GET /v1/health
       │
       ├── last_updated unchanged ──> use local store.json
       │
       └── last_updated changed ────> GET /v1/store once

With a token configured, the snapshot comes from GET /v1/private instead, which includes private repositories. A cached snapshot of the other kind is re-downloaded even if last_updated is unchanged.

Manual refresh is explicit:

REFRESH
  └─ POST /v1/refresh, repeated until Echopoint's due queue is empty
       └─ each call is one Worker run with a fixed fetch budget
  └─ verify last_updated
       └─ download the snapshot once only if changed

Desktop app

echohub opens the window straight away and checks Echopoint in the background, so a slow or unreachable server never blocks startup. The first run shows a welcome screen until the first snapshot arrives; after that the saved snapshot loads instantly. Failures are explained in plain words (unreachable, rejected token, and so on) while the last snapshot stays on screen.

Configuration

Quick start

# Requires Python 3.11+

# Sync with the server
python run.py sync

# Run tests
python -m pytest

# Run the desktop app and the TUI
python run.py gui
python run.py tui

# Install the package locally
python -m pip install -e .
echohub

# Offline mode (no network access)
python run.py --offline gui
python run.py --offline tui

# Demo mode (no network access, no data)
python run.py --demo gui
python run.py --demo tui

Controls

License

MIT licensed.