#279 · Create a hardware-free RF units practice CLI
Last checked with GitLab: . Status comes from GitLab using a 2-minute cache. Merge events clear affected cached statuses. An already-open page does not update itself. Refresh page.
An MR completes this bounty when it is merged into main with Closes #279 and GitLab closes the issue. A mention or an updated timestamp is not completion. Awarded points appear in Activity.
cp .dev.vars.example .dev.vars && pnpm dev, after rebasing on main) and fully test your change before opening the MR.
Description
The RF learning pipeline names Python and signals fundamentals; give new radio learners an executable set of small unit exercises before they buy equipment.
Who might enjoy this
- Community interests: RF / SDR (Dragon), Tech
- Skills: python, docs
- Experience: starter; work style: analytical.
- Readiness: ready; bounty size: S (existing points tier; standard merge award stacks separately).
Current behavior and starting points
Source-reviewed against main cf05b29c6256dba70d0ebc09b22cc9867cdb786a on2026-10-18. Check current main and related issues/MRs before implementing so existing work is reused.
Relevant Files
- apps/wiki/src/content/docs/radio/rf-learning-pipeline.md
- apps/wiki/src/content/docs/radio/software-defined-radios-sdrs.md
Deliverables
- A Python standard-library CLI and original synthetic exercise JSON for Hz/kHz/MHz, period and dB power ratios.
- A short RF learning-pipeline section explaining units and example commands.
Dependencies and decisions
No prerequisite issue is required. Re-read current main and linked MRs before starting.
Acceptance criteria
- [ ] A 1 MHz fixture reports 1000000 Hz and a 1 microsecond period within documented tolerance; 10 dB power ratio reports 10.
- [ ] Zero/negative frequency, invalid unit, nonfinite number and a malformed exercise are rejected with a named reason and nonzero exit status.
- [ ] Run the CLI and its unittest suite with network disabled; changing one conversion constant makes a named expected-answer check fail.
- [ ] Record named baseline failures and the exact commands used. A behavior fix includes a real route/database/protocol check observed failing before the change. Knowledge work includes source traceability and reproducible reviewer evidence.
- [ ] Run the affected app's existing checks. Explain any baseline failures rather than reporting a matching failure count as proof.
Try it locally
Start from the existing source files above. The following is the target demo your contribution should enable; a newly proposed script or fixture is part of the deliverable:
Run python3 apps/wiki/scripts/rf_units_practice.py --examples; change a synthetic value and compare the worked answer.
Use public or synthetic examples. Starter work should run without production access; explicitly name any software/device prerequisite before claiming it is ready.
Out of scope
- No transmitter configuration, antenna range prediction or purchase recommendations.
- Do not replace or duplicate the existing chat math parser or #240; this is a teaching CLI with a fixed tiny exercise schema.
- Unrelated refactors, new services/providers, bulk dependency changes, production access changes, unrequested notifications, and copying private member material. Keep credentials and unresolved security findings outside the issue and repository.
For a coding agent and reviewer
Read AGENTS.md, applicable .cursor/rules/, app instructions and docs/contributing/agentic-bounty-review.md. Reuse the existing shared helpers, identity/access paths and app styling. Implement one bounded story and provide evidence the accepting app maintainer can reproduce. State updated / pre-release verified / released / live verified accurately.
A parent index carries no duplicate award for these child deliverables. Open one scoped MR using this issue's actual number after the closing keyword. Link your GitLab identity on Scoreboard; the existing merge webhook handles eligible points.
Catalog index: #258.
<!-- community-interest-bounty:2026-10-18:rf-unit-practice -->
Relevant files
-
[apps/wiki/src/content/docs/radio/rf-learning-pipeline.md](https://git.juntogroups.org/irregulars/irregularchat-monorepo/-/blob/main/apps/wiki/src/content/docs/radio/rf-learning-pipeline.md)from issue -
[apps/wiki/src/content/docs/radio/software-defined-radios-sdrs.md](https://git.juntogroups.org/irregulars/irregularchat-monorepo/-/blob/main/apps/wiki/src/content/docs/radio/software-defined-radios-sdrs.md)from issue
Hints
No hints yet.
Activity
No points have been awarded for this bounty yet.
Comments
Sign in to join the discussion.
No comments yet. Be the first to weigh in.