Sign inSign up

lfmanifesto/hfnet-planner-api

By lfmanifesto

•Updated 7 months ago

HF comm window planner API - VOACAP + spots + CloudRF for JS8Call, VARA HF, Reticulum

Image
1

2.6K

lfmanifesto/hfnet-planner-api repository overview

⁠HFNet Planner API

HF propagation planning engine. VOACAP 24-hour SNR predictions across 10 HF bands (160m-10m), overlaid with real-time WSPR/PSK spots and optional CloudRF terrain modeling.

⁠Quick Start

docker pull lfmanifesto/hfnet-planner-api:latest
docker pull lfmanifesto/hfnet-planner-ui:latest
docker network create hfnet
docker run -d --name api --network hfnet lfmanifesto/hfnet-planner-api:latest
docker run -d --name ui --network hfnet -p 8880:80 lfmanifesto/hfnet-planner-ui:latest

Open http://localhost:8880⁠

⁠Architecture

  • amd64 + arm64 multi-arch (Windows, macOS, Linux)
  • FastAPI backend on port 8000 (internal)
  • VOACAP propagation engine with ISOTROPE antennas + equipment offsets
  • SNR priority: spots (WSPR/PSK) > CloudRF > VOACAP > None
  • Per-band NVIS detection (freq <= foF2 AND distance <= 500km)
  • Per-band above-MUF using VOACAP muf_day statistics
  • NVIS bands override oblique MUF (near-vertical incidence geometry)
  • 10 digital mode threshold checks per band per hour

⁠API Endpoints

MethodPathDescription
POST/api/commplanStart comm plan (async, returns task_id)
GET/api/commplan/{id}Get plan status/results
GET/api/commplan/{id}/exportPlain text export for OPORD
GET/api/presetsStation wizard presets
GET/api/solarCurrent solar conditions
GET/api/sourcesData source status
GET/api/stationsSaved station profiles

⁠Data Sources

  • VOACAP - ITU ionospheric propagation model (24h predictions)
  • wspr.live - WSPR spot database (ClickHouse)
  • pskreporter.info - PSK/FT8/JS8/CW spot reports
  • prop.kc2g.com - Real-time foF2/MUF from ionosondes
  • hamqsl.com - Solar indices (SFI, K-index)
  • cloudrf.com - Terrain-aware NVIS modeling (optional)

⁠Version

v4.0.0 (Feb 2026) - Raw VOACAP SNR architecture. 363 backend tests.

Tag summary

Content type

Image

Digest

sha256:93f9b2de4…

Size

69.7 MB

Last updated

7 months ago

docker pull lfmanifesto/hfnet-planner-api