kel-agent

kel-agent is a protocol bridge/translator between amateur radio software and WebSocket clients. Despite the name, "agent" here refers to a background service, not an AI agent.

This bridge was built to support https://github.com/k0swe/forester but can be used by any web application that needs to communicate with amateur radio installed programs.

flowchart LR
    Internet([Internet]) --- Application[Web Application]
    subgraph Computer
        subgraph Browser[Web Browser]
            Application
        end
        agent[kel-agent]
        WSJTX[WSJT-X]
        rigctld[rigctl/Hamlib]
        HRD[HRD]
        etc[...]
    end
    Application ---|websocket| agent
    agent ---|UDP| WSJTX
    agent ---|lib| rigctld
    agent -.->|UDP| HRD
    agent -.-> etc
    style agent fill:#8ecfff,stroke:#1f2937,stroke-width:2px,color:#000

Loading

This currently supports communication with WSJT-X, and now officially supports rig control via rigctl/Hamlib. Ham Radio Deluxe support remains planned.

To get started using kel-agent, download an appropriate executable from the latest release. Windows, Mac, Debian/Ubuntu Linux and Raspberry Pi installers are available.

See the Running documentation for how to configure, execute and serve kel-agent.

Acknowledgements

The wire logo for kel-agent was created by Freepik on Flaticon.