How 777arc/gnuradio-world works
GNU Radio World runs GNU Radio flowgraphs in a browser. A user loads an example or edits a graph, then runs it in the WebAssembly runtime; browser-connected SDRs and remote radios can provide live input, while recordings support offline exploration. The editor also offers AI-assisted graph work, examples, sharing, and recording submission. The README documents these product capabilities, but many implementation details—especially recording views and runtime wiring—were not sampled, so those relationships are shown only where documented.
Main entry points: main.ts Graph Workspace · panel.ts AI Assistant Panel · runner.cpp Flowgraph Runtime · tools.ts Graph AI Tools
Components 26
Flowgraph Editor
- Graph Workspace
editor/src/main.ts - Graph Model
editor/src/graph-model.ts - Block Definitions
editor/src/block-defs.ts - Example Catalog
editor/src/example-catalog.ts - Challenges
editor/src/challenge.ts
Browser Runtime
- Flowgraph Runtime
runner/src/runner.cpp - Block Implementations
blocks/overlays - Embedded Python
runner/src/pyodide/py/grworld.py
Signal Sources
- Browser SDR Inputs
editor/src/usb-radio.ts
Recordings
- Recording Explorer
editor/src/recording/pages/recording-view/recording-view.tsx - Recording Catalog
editor/src/recording-catalog.ts - Recording Data API
editor/src/recording/api/iqdata/UrlClient.ts - Recording Upload
editor/src/recording-upload.ts
AI Assistance
- AI Assistant Panel
editor/src/ai/panel.ts - Graph AI Tools
editor/src/ai/tools.ts - Block Catalog
editor/src/ai/catalog.ts - Graph Capture
editor/src/ai/capture.ts - AI Harness
editor/src/ai/harness.ts - AI Knowledge
editor/src/ai/knowledge.ts - AI Request Client
editor/src/ai/client.ts - AI Providers
editor/src/ai/providers.ts
Remote Radio
- GRWire Daemon
grwire/src/lib.rs
Other components
- Radio User
- AI Proxy
workers/ai-proxy/src/index.js - Remote SDR
- Static Web Server
server.mjs
Connections 27
- Radio User → Graph Workspace: edits graph
README.md - Graph Workspace → Graph Model: manipulates
editor/src/main.ts - Graph Workspace → Block Definitions: uses definitions
editor/src/main.ts - Graph Workspace → Example Catalog: offers examples
README.md - Graph Workspace → Challenges: checks challenges
editor/src/main.ts - Graph Workspace → Flowgraph Runtime: runs flowgraph
README.md - Flowgraph Runtime → Block Implementations: executes blocks
README.md - Flowgraph Runtime → Embedded Python: hosts embedded Python
README.md - Browser SDR Inputs → Flowgraph Runtime: provides samples
README.md - Radio User → Recording Explorer: explores recordings
README.md - Recording Explorer → Recording Catalog: browses catalog
- Recording Explorer → Recording Data API: fetches IQ data
- Radio User → Recording Upload: submits recording
README.md - Graph Workspace → AI Assistant Panel: opens assistance
editor/src/main.ts - AI Assistant Panel → Graph AI Tools: invokes tools
editor/src/ai/panel.ts - AI Assistant Panel → Graph Capture: captures graph state
editor/src/ai/panel.ts - AI Assistant Panel → AI Harness: uses harness
editor/src/ai/panel.ts - AI Assistant Panel → AI Knowledge: uses knowledge
editor/src/ai/panel.ts - Graph AI Tools → Block Catalog: searches blocks
editor/src/ai/tools.ts - Graph AI Tools → Graph Model: reads graph
editor/src/ai/tools.ts - Graph AI Tools → Block Definitions: reads definitions
editor/src/ai/tools.ts - AI Assistant Panel → AI Request Client: requests completion
editor/src/ai/panel.ts - AI Request Client → AI Providers: selects provider
editor/src/ai/client.ts - AI Request Client → AI Proxy: sends hosted request
- Remote SDR → GRWire Daemon: streams radio data
grwire/src/lib.rs - GRWire Daemon → Flowgraph Runtime: bridges to browser
README.md - Radio User → Static Web Server: loads application
README.md