# 777arc/gnuradio-world architecture

> Architecture diagram of the GitHub repository 777arc/gnuradio-world, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/777arc/gnuradio-world
- Repository: https://github.com/777arc/gnuradio-world

## Overview

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: [`editor/src/main.ts`](https://github.com/777arc/gnuradio-world/blob/main/editor/src/main.ts) (Graph Workspace), [`editor/src/ai/panel.ts`](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/panel.ts) (AI Assistant Panel), [`runner/src/runner.cpp`](https://github.com/777arc/gnuradio-world/blob/main/runner/src/runner.cpp) (Flowgraph Runtime), [`editor/src/ai/tools.ts`](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/tools.ts) (Graph AI Tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Flowgraph Editor"]
  node_editor_app["Graph Workspace<br/>[main.ts]"]
  node_graph_model["Graph Model<br/>[graph-model.ts]"]
  node_block_defs["Block Definitions<br/>[block-defs.ts]"]
  node_example_catalog["Example Catalog<br/>[example-catalog.ts]"]
  node_challenge["Challenges<br/>[challenge.ts]"]
end

subgraph group_runtime["Browser Runtime"]
  node_runtime_engine["Flowgraph Runtime<br/>[runner.cpp]"]
  node_block_overlays["Block Implementations"]
  node_python_blocks["Embedded Python<br/>[grworld.py]"]
end

subgraph group_signals["Signal Sources"]
  node_device_inputs["Browser SDR Inputs<br/>[usb-radio.ts]"]
end

subgraph group_recordings["Recordings"]
  node_recording_editor["Recording Explorer<br/>[recording-view.tsx]"]
  node_recording_catalog["Recording Catalog"]
  node_recording_api["Recording Data API<br/>[UrlClient.ts]"]
  node_recording_upload["Recording Upload"]
end

subgraph group_ai["AI Assistance"]
  node_ai_panel["AI Assistant Panel<br/>[panel.ts]"]
  node_ai_tools["Graph AI Tools<br/>[tools.ts]"]
  node_ai_catalog["Block Catalog<br/>[catalog.ts]"]
  node_ai_capture["Graph Capture<br/>[capture.ts]"]
  node_ai_harness["AI Harness<br/>[harness.ts]"]
  node_ai_knowledge["AI Knowledge<br/>[knowledge.ts]"]
  node_ai_client["AI Request Client<br/>[client.ts]"]
  node_ai_providers["AI Providers<br/>[providers.ts]"]
end

subgraph group_remote["Remote Radio"]
  node_grwire["GRWire Daemon<br/>[lib.rs]"]
end

node_user(("Radio User"))
node_ai_proxy["AI Proxy<br/>[index.js]"]
node_radio(("Remote SDR"))
node_dev_server["Static Web Server<br/>[server.mjs]"]

node_user -->|"edits graph"| node_editor_app
node_editor_app -->|"manipulates"| node_graph_model
node_editor_app -->|"uses definitions"| node_block_defs
node_editor_app -->|"offers examples"| node_example_catalog
node_editor_app -->|"checks challenges"| node_challenge
node_editor_app -->|"runs flowgraph"| node_runtime_engine
node_runtime_engine -->|"executes blocks"| node_block_overlays
node_runtime_engine -->|"hosts embedded Python"| node_python_blocks
node_device_inputs -->|"provides samples"| node_runtime_engine
node_user -->|"explores recordings"| node_recording_editor
node_recording_editor -.->|"browses catalog"| node_recording_catalog
node_recording_editor -.->|"fetches IQ data"| node_recording_api
node_user -->|"submits recording"| node_recording_upload
node_editor_app -.->|"opens assistance"| node_ai_panel
node_ai_panel -->|"invokes tools"| node_ai_tools
node_ai_panel -->|"captures graph state"| node_ai_capture
node_ai_panel -->|"uses harness"| node_ai_harness
node_ai_panel -->|"uses knowledge"| node_ai_knowledge
node_ai_tools -->|"searches blocks"| node_ai_catalog
node_ai_tools -->|"reads graph"| node_graph_model
node_ai_tools -->|"reads definitions"| node_block_defs
node_ai_panel -->|"requests completion"| node_ai_client
node_ai_client -->|"selects provider"| node_ai_providers
node_ai_client -.->|"sends hosted request"| node_ai_proxy
node_radio -->|"streams radio data"| node_grwire
node_grwire -->|"bridges to browser"| node_runtime_engine
node_user -->|"loads application"| node_dev_server

click node_editor_app "https://github.com/777arc/gnuradio-world/blob/main/editor/src/main.ts"
click node_graph_model "https://github.com/777arc/gnuradio-world/blob/main/editor/src/graph-model.ts"
click node_block_defs "https://github.com/777arc/gnuradio-world/blob/main/editor/src/block-defs.ts"
click node_example_catalog "https://github.com/777arc/gnuradio-world/blob/main/editor/src/example-catalog.ts"
click node_challenge "https://github.com/777arc/gnuradio-world/blob/main/editor/src/challenge.ts"
click node_runtime_engine "https://github.com/777arc/gnuradio-world/blob/main/runner/src/runner.cpp"
click node_block_overlays "https://github.com/777arc/gnuradio-world/tree/main/blocks/overlays"
click node_python_blocks "https://github.com/777arc/gnuradio-world/blob/main/runner/src/pyodide/py/grworld.py"
click node_device_inputs "https://github.com/777arc/gnuradio-world/blob/main/editor/src/usb-radio.ts"
click node_recording_editor "https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording/pages/recording-view/recording-view.tsx"
click node_recording_catalog "https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording-catalog.ts"
click node_recording_api "https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording/api/iqdata/UrlClient.ts"
click node_recording_upload "https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording-upload.ts"
click node_ai_panel "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/panel.ts"
click node_ai_tools "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/tools.ts"
click node_ai_catalog "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/catalog.ts"
click node_ai_capture "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/capture.ts"
click node_ai_harness "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/harness.ts"
click node_ai_knowledge "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/knowledge.ts"
click node_ai_client "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/client.ts"
click node_ai_providers "https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/providers.ts"
click node_ai_proxy "https://github.com/777arc/gnuradio-world/blob/main/workers/ai-proxy/src/index.js"
click node_grwire "https://github.com/777arc/gnuradio-world/blob/main/grwire/src/lib.rs"
click node_dev_server "https://github.com/777arc/gnuradio-world/blob/main/server.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_editor_app,node_graph_model,node_block_defs,node_example_catalog,node_challenge,node_user toneBlue
class node_runtime_engine,node_block_overlays,node_python_blocks toneAmber
class node_device_inputs,node_dev_server toneMint
class node_recording_editor,node_recording_catalog,node_recording_api,node_recording_upload toneRose
class node_ai_panel,node_ai_tools,node_ai_catalog,node_ai_capture,node_ai_harness,node_ai_knowledge,node_ai_client,node_ai_providers,node_radio toneIndigo
class node_grwire,node_ai_proxy toneTeal
```

## Components

### Flowgraph Editor

- [Graph Workspace](https://github.com/777arc/gnuradio-world/blob/main/editor/src/main.ts): `editor/src/main.ts`
- [Graph Model](https://github.com/777arc/gnuradio-world/blob/main/editor/src/graph-model.ts): `editor/src/graph-model.ts`
- [Block Definitions](https://github.com/777arc/gnuradio-world/blob/main/editor/src/block-defs.ts): `editor/src/block-defs.ts`
- [Example Catalog](https://github.com/777arc/gnuradio-world/blob/main/editor/src/example-catalog.ts): `editor/src/example-catalog.ts`
- [Challenges](https://github.com/777arc/gnuradio-world/blob/main/editor/src/challenge.ts): `editor/src/challenge.ts`

### Browser Runtime

- [Flowgraph Runtime](https://github.com/777arc/gnuradio-world/blob/main/runner/src/runner.cpp): `runner/src/runner.cpp`
- [Block Implementations](https://github.com/777arc/gnuradio-world/tree/main/blocks/overlays): `blocks/overlays`
- [Embedded Python](https://github.com/777arc/gnuradio-world/blob/main/runner/src/pyodide/py/grworld.py): `runner/src/pyodide/py/grworld.py`

### Signal Sources

- [Browser SDR Inputs](https://github.com/777arc/gnuradio-world/blob/main/editor/src/usb-radio.ts): `editor/src/usb-radio.ts`

### Recordings

- [Recording Explorer](https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording/pages/recording-view/recording-view.tsx): `editor/src/recording/pages/recording-view/recording-view.tsx`
- [Recording Catalog](https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording-catalog.ts): `editor/src/recording-catalog.ts`
- [Recording Data API](https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording/api/iqdata/UrlClient.ts): `editor/src/recording/api/iqdata/UrlClient.ts`
- [Recording Upload](https://github.com/777arc/gnuradio-world/blob/main/editor/src/recording-upload.ts): `editor/src/recording-upload.ts`

### AI Assistance

- [AI Assistant Panel](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/panel.ts): `editor/src/ai/panel.ts`
- [Graph AI Tools](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/tools.ts): `editor/src/ai/tools.ts`
- [Block Catalog](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/catalog.ts): `editor/src/ai/catalog.ts`
- [Graph Capture](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/capture.ts): `editor/src/ai/capture.ts`
- [AI Harness](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/harness.ts): `editor/src/ai/harness.ts`
- [AI Knowledge](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/knowledge.ts): `editor/src/ai/knowledge.ts`
- [AI Request Client](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/client.ts): `editor/src/ai/client.ts`
- [AI Providers](https://github.com/777arc/gnuradio-world/blob/main/editor/src/ai/providers.ts): `editor/src/ai/providers.ts`

### Remote Radio

- [GRWire Daemon](https://github.com/777arc/gnuradio-world/blob/main/grwire/src/lib.rs): `grwire/src/lib.rs`

### Other components

- **Radio User**
- [AI Proxy](https://github.com/777arc/gnuradio-world/blob/main/workers/ai-proxy/src/index.js): `workers/ai-proxy/src/index.js`
- **Remote SDR**
- [Static Web Server](https://github.com/777arc/gnuradio-world/blob/main/server.mjs): `server.mjs`

## Connections

- Radio User → Graph Workspace: edits graph (evidence: `README.md`)
- Graph Workspace → Graph Model: manipulates (evidence: `editor/src/main.ts`)
- Graph Workspace → Block Definitions: uses definitions (evidence: `editor/src/main.ts`)
- Graph Workspace → Example Catalog: offers examples (evidence: `README.md`)
- Graph Workspace → Challenges: checks challenges (evidence: `editor/src/main.ts`)
- Graph Workspace → Flowgraph Runtime: runs flowgraph (evidence: `README.md`)
- Flowgraph Runtime → Block Implementations: executes blocks (evidence: `README.md`)
- Flowgraph Runtime → Embedded Python: hosts embedded Python (evidence: `README.md`)
- Browser SDR Inputs → Flowgraph Runtime: provides samples (evidence: `README.md`)
- Radio User → Recording Explorer: explores recordings (evidence: `README.md`)
- Recording Explorer → Recording Catalog: browses catalog
- Recording Explorer → Recording Data API: fetches IQ data
- Radio User → Recording Upload: submits recording (evidence: `README.md`)
- Graph Workspace → AI Assistant Panel: opens assistance (evidence: `editor/src/main.ts`)
- AI Assistant Panel → Graph AI Tools: invokes tools (evidence: `editor/src/ai/panel.ts`)
- AI Assistant Panel → Graph Capture: captures graph state (evidence: `editor/src/ai/panel.ts`)
- AI Assistant Panel → AI Harness: uses harness (evidence: `editor/src/ai/panel.ts`)
- AI Assistant Panel → AI Knowledge: uses knowledge (evidence: `editor/src/ai/panel.ts`)
- Graph AI Tools → Block Catalog: searches blocks (evidence: `editor/src/ai/tools.ts`)
- Graph AI Tools → Graph Model: reads graph (evidence: `editor/src/ai/tools.ts`)
- Graph AI Tools → Block Definitions: reads definitions (evidence: `editor/src/ai/tools.ts`)
- AI Assistant Panel → AI Request Client: requests completion (evidence: `editor/src/ai/panel.ts`)
- AI Request Client → AI Providers: selects provider (evidence: `editor/src/ai/client.ts`)
- AI Request Client → AI Proxy: sends hosted request
- Remote SDR → GRWire Daemon: streams radio data (evidence: `grwire/src/lib.rs`)
- GRWire Daemon → Flowgraph Runtime: bridges to browser (evidence: `README.md`)
- Radio User → Static Web Server: loads application (evidence: `README.md`)
