rfmux

rfmux is the Python API for t0.technology's Control and Readout System (CRS), a hardware platform designed for operating large arrays of Kinetic Inductance Detectors (KIDs) used in radio astronomy and quantum sensing applications.

The CRS + MKIDs firmware is described in this conference proceedings.

Quick Start

Installation

New in 2025: rfmux is now available on PyPI. We recommend using uv for installation:

# Install uv (if not already installed)
$ curl -LsSf https://astral.sh/uv/install.sh | sh  # Linux/macOS or WSL
# Or: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows

# Create virtual environment 
uv venv ### or uv venv my-env-name
source .venv/bin/activate # On Windows: .venv/Scripts/activate
# or source my-env-name/bin/activate

# Install rfmux
$ uv pip install rfmux

Note: rfmux now uses a C++ extension for packet processing. PyPI hosts pre-built binaries (wheels) for common platforms (Linux x86_64, macOS, Windows). If wheels aren't available for your platform, you'll need a C++ compiler. See Installation Guide for details.

Interactive GUI

To launch the Periscope GUI, run:

$ uv run periscope # or periscope

https://github.com/user-attachments/assets/581d4ff8-5ea2-493a-9c9c-c93d6ca847e2

Scripting with Mock Mode

If you do not have a CRS board (or cryogenic detectors) handy, you can use "mock" mode for a software emulation:

# Emulate CRS hardware for offline development
s = rfmux.load_session("""
!HardwareMap
- !flavour "rfmux.mock"
- !CRS { serial: "MOCK0001" }
""")

Scripting with CRS Hardware

To control a single network-attached CRS from your PC's Python prompt, use:

import rfmux

# Connect to a CRS board
s = rfmux.load_session('!HardwareMap [ !CRS { serial: "0033" } ]')
crs = s.query(rfmux.CRS).one()
await crs.resolve()

# Acquire samples
samples = await crs.get_samples(1000, channel=1, module=1)

Documentation

Installation Guide - Detailed installation for all platforms, building from source
Getting Started - Usage patterns, hardware hierarchy, common operations
Networking Guide - UDP tuning, multicast configuration, troubleshooting
Firmware Guide - Fetching, managing, and flashing firmware

Repository Structure

rfmux/
├── docs/                # Documentation
├── firmware/            # Firmware binaries (Git LFS)
├── home/                # Jupyter Hub content (demos, docs)
├── rfmux/               # Main Python package
│   ├── algorithms/      # Network analysis, fitting, biasing
│   ├── core/            # Hardware schema, sessions, mock infrastructure
│   ├── packets/         # C++ packet receiver library
│   ├── tools/           # Periscope GUI and other tools
│   └── tuber/           # RPC/remote-object communication
└── test/                # Test suite (unit, integration, QC)

Contributing & Feedback

rfmux is permissively licensed; see LICENSE for details.

We actively encourage contributions and feedback. Understanding operator needs is how we determine what to add to rfmux.

Pull Requests: Your contributions are welcome
Issues: Please submit tickets for bugs or enhancement suggestions
Collaborator Slack: Join #crs-collaboration - email Joshua@t0.technology with your name, affiliation, and project

Citation

When citing rfmux or CRS, please reference:

CRS + MKIDs Conference Proceedings: https://arxiv.org/abs/2406.16266

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rfmux-1.6.0.tar.gz (476.6 kB view details)

Uploaded Jul 16, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

rfmux-1.6.0-cp314-cp314-win_amd64.whl (681.6 kB view details)

Uploaded Jul 16, 2026 CPython 3.14Windows x86-64

rfmux-1.6.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (716.6 kB view details)

Uploaded Jul 16, 2026 CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

rfmux-1.6.0-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (696.1 kB view details)

Uploaded Jul 16, 2026 CPython 3.14manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

rfmux-1.6.0-cp314-cp314-macosx_11_0_arm64.whl (659.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.14macOS 11.0+ ARM64

rfmux-1.6.0-cp314-cp314-macosx_10_15_x86_64.whl (676.8 kB view details)

Uploaded Jul 16, 2026 CPython 3.14macOS 10.15+ x86-64

rfmux-1.6.0-cp313-cp313-win_amd64.whl (676.1 kB view details)

Uploaded Jul 16, 2026 CPython 3.13Windows x86-64

rfmux-1.6.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (716.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

rfmux-1.6.0-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (695.6 kB view details)

Uploaded Jul 16, 2026 CPython 3.13manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

rfmux-1.6.0-cp313-cp313-macosx_11_0_arm64.whl (659.2 kB view details)

Uploaded Jul 16, 2026 CPython 3.13macOS 11.0+ ARM64

rfmux-1.6.0-cp313-cp313-macosx_10_13_x86_64.whl (676.5 kB view details)

Uploaded Jul 16, 2026 CPython 3.13macOS 10.13+ x86-64

rfmux-1.6.0-cp312-cp312-win_amd64.whl (676.0 kB view details)

Uploaded Jul 16, 2026 CPython 3.12Windows x86-64

rfmux-1.6.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (716.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

rfmux-1.6.0-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (695.6 kB view details)

Uploaded Jul 16, 2026 CPython 3.12manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

rfmux-1.6.0-cp312-cp312-macosx_11_0_arm64.whl (659.2 kB view details)

Uploaded Jul 16, 2026 CPython 3.12macOS 11.0+ ARM64

rfmux-1.6.0-cp312-cp312-macosx_10_13_x86_64.whl (676.4 kB view details)

Uploaded Jul 16, 2026 CPython 3.12macOS 10.13+ x86-64

rfmux-1.6.0-cp311-cp311-win_amd64.whl (672.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.11Windows x86-64

rfmux-1.6.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (715.9 kB view details)

Uploaded Jul 16, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

rfmux-1.6.0-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (694.6 kB view details)

Uploaded Jul 16, 2026 CPython 3.11manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

rfmux-1.6.0-cp311-cp311-macosx_11_0_arm64.whl (658.4 kB view details)

Uploaded Jul 16, 2026 CPython 3.11macOS 11.0+ ARM64

rfmux-1.6.0-cp311-cp311-macosx_10_9_x86_64.whl (674.0 kB view details)

Uploaded Jul 16, 2026 CPython 3.11macOS 10.9+ x86-64

rfmux-1.6.0-cp310-cp310-win_amd64.whl (671.9 kB view details)

Uploaded Jul 16, 2026 CPython 3.10Windows x86-64

rfmux-1.6.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (715.3 kB view details)

Uploaded Jul 16, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

rfmux-1.6.0-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (694.4 kB view details)

Uploaded Jul 16, 2026 CPython 3.10manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

rfmux-1.6.0-cp310-cp310-macosx_11_0_arm64.whl (656.8 kB view details)

Uploaded Jul 16, 2026 CPython 3.10macOS 11.0+ ARM64

rfmux-1.6.0-cp310-cp310-macosx_10_9_x86_64.whl (672.6 kB view details)

Uploaded Jul 16, 2026 CPython 3.10macOS 10.9+ x86-64

rfmux-1.6.0-cp39-cp39-win_amd64.whl (672.2 kB view details)

Uploaded Jul 16, 2026 CPython 3.9Windows x86-64

rfmux-1.6.0-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (715.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.9manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

rfmux-1.6.0-cp39-cp39-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl (694.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.9manylinux: glibc 2.26+ ARM64manylinux: glibc 2.28+ ARM64

rfmux-1.6.0-cp39-cp39-macosx_11_0_arm64.whl (656.9 kB view details)

Uploaded Jul 16, 2026 CPython 3.9macOS 11.0+ ARM64

rfmux-1.6.0-cp39-cp39-macosx_10_9_x86_64.whl (672.7 kB view details)

Uploaded Jul 16, 2026 CPython 3.9macOS 10.9+ x86-64

File details

Details for the file rfmux-1.6.0.tar.gz.

File metadata

Download URL: rfmux-1.6.0.tar.gz
Upload date: Jul 16, 2026
Size: 476.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rfmux-1.6.0.tar.gz
Algorithm	Hash digest
SHA256	`a472a4e35c764e2be0ed279f9a897eb2f3d74693143edb76e1f404592e143a85`
MD5	`c882d63d6d2a849b26ad566b75b5bf0f`
BLAKE2b-256	`39a165c093afd631d44dbf2cb6eae0490eccbbc8c3cc6eaa60f53435a9445d12`

Algorithm	Hash digest
SHA256	`0ade433043da37aa1f6beb9260ec70b6651d89f8be724510a806cc0ae768386d`
MD5	`a81ce4f4f3e70e4968ae22abe6c2bfb9`
BLAKE2b-256	`455e9d129ad31eccf785b1b002044fbcf364f386b46a697fcf85815927059401`

Algorithm	Hash digest
SHA256	`c2f2d1595d452f0c7a0d6fcd9d38c302e408cafa10dffeb564685826b9b21edc`
MD5	`b05aa32d8baecd105491d231078595ab`
BLAKE2b-256	`71653b0af7942fd7e058e68a225f9a8f59df97f8f981293ea272457ada9ef18d`

Algorithm	Hash digest
SHA256	`8376ccef35e2506d8fd08c627a9f3634a419d2ddac3933b712e8b9c6c53d2aac`
MD5	`212594e852bfa6624657358c3df10fd0`
BLAKE2b-256	`2e1a9d05ada6949a6297596c56cd5ed1a8df31f2515af0ba86dc390ceeae281c`

Algorithm	Hash digest
SHA256	`225e82b6f555bc1414e6c448d399e40d02e3796ea39c632746c041ef5ea7ff91`
MD5	`bda3116f94b03e52445aecdca325f17f`
BLAKE2b-256	`62776fa1fe643645271141b63f9e6a6ff21287a12b706ba98a6bed753561d890`

Algorithm	Hash digest
SHA256	`2157a546291a345e911ecda8350ce2b29e89fd1e95e77b3b77fed14dbb02bd72`
MD5	`ff90a35799523f749d4e4f936cfba8e9`
BLAKE2b-256	`f7c523547994bdb14c85ae60747dc8f7344642c67433d0ead703441378bc6853`

Algorithm	Hash digest
SHA256	`00cc99f37787da6977b31a7c5c8d6e20373c9d65679d6a3b265a18f0ab549816`
MD5	`7361a283695c20a1fa38f4456fe949d3`
BLAKE2b-256	`622143463b786b591da2cc55bacce46e4ad6b41d16e1574d87f25ab71d3da5b4`

Algorithm	Hash digest
SHA256	`924a965851848085cc911e57bf25a4150b6cc342758de0ad30d9cb546f850682`
MD5	`4ad50896c1a37b1f31e3b28dc3593c77`
BLAKE2b-256	`9ad5932c4aa3a3270e3f6e4640d1b8a3809a7bb388944ea5b124f7fafc248fbf`

Algorithm	Hash digest
SHA256	`64cee9792101da7a656366ae7ee0578ddc92baa9607056293acb1234a8c5a26f`
MD5	`12591e9120c4ec01bb17bdebb9b4e31c`
BLAKE2b-256	`04f65fd56099de4ef8cfb98f91f901ee27e76772baac2e1ff6904f721111d02d`

Algorithm	Hash digest
SHA256	`504e0b8197c4dd4dcfd575eb8aaeafe18485fdbfcd7b6da03165583b3b2a22d5`
MD5	`213b7e59a863c970dfc2a55eefa6d548`
BLAKE2b-256	`f0fe6934c68ac8f1bd62c293d51d0dfbc8a0f43667134d120da5f975c297a023`

Algorithm	Hash digest
SHA256	`3d53fb666ac05d1e5e1f91af9c4db2a93577c959c1c7090d1962f0c364c099dc`
MD5	`e0660e21cd56e52ce880a8a7b15c9d2b`
BLAKE2b-256	`b504309bf9628cba7c059657a1106d08093c8422ab54cd6cea941ae151f95afd`

Algorithm	Hash digest
SHA256	`d0e34bb434d6b5d0446107bcea1baa2820f07c075f0b4fc23f79e1d2d62a3c72`
MD5	`7225084c11a313163250af1622763328`
BLAKE2b-256	`ab4c4a0889d9783d9a37ddfdca99e9ffe6ba1a766a2cd4d653ca1f56e6608fe2`

Algorithm	Hash digest
SHA256	`9efc1b90ac41442125c65b967fa4e1ca3a5d58b3ffa38fadef094012f5a172aa`
MD5	`2b2f160af55c5c4d19f0fc8ae8499b86`
BLAKE2b-256	`7aec1bc262e4da5471d388dacdced697451bae56e6b0f06f33bca40831756d71`

Algorithm	Hash digest
SHA256	`f5fd987469dab0b296724087d8e552855eda1dd744cfc30969f49291465252ff`
MD5	`1515358560eefad87fc819d5220ebae2`
BLAKE2b-256	`33686e7dcc1d032580ea4dc0e166af6ee3003801fb97a90fd94d179dd52fea19`

Algorithm	Hash digest
SHA256	`c07624b2584434550d9392062a5fa682dbad67e2747953950ce76d44e85e2e73`
MD5	`4b560c931b8729b71f1717d492ae6770`
BLAKE2b-256	`353a6ff02dc263c5a26ecaadd6639458da72155158e8edd917f4c219ba8d1cf0`

Algorithm	Hash digest
SHA256	`b13636ea130fbd70e5d86ced64dc8e30ecc159bc72a2b5e23c68121960aad43b`
MD5	`c9c173909002c332844431abaec9a411`
BLAKE2b-256	`57ef50a23aa418faedc18f4f943c8f3ebf4abc390bc87c2e90750c8de796b111`

Algorithm	Hash digest
SHA256	`3e40d60f03e1189d71fb405f143b6bb6c816acfe7fa65cea7e377502b00df361`
MD5	`dd98afcb8c3ac16e4c006c943cd767bd`
BLAKE2b-256	`98892fe4c1849bb720ea70a5ef293b7fac292da1c89f20acd8cfb2dbe3a0b491`

Algorithm	Hash digest
SHA256	`6f0a5cb50c644b36b17fb3f38caf2e75132b4f22c7f2122ed2a749d08d676c04`
MD5	`1994909ca28b71e8ba5f085f5aaf59e7`
BLAKE2b-256	`da83aeb82ff00f3201ea0b1d6a694684f7c7611d06a7110a1afb0152b64730b3`

Algorithm	Hash digest
SHA256	`c670cb49b986475860fa26556673ebfcdacf4a5482024f5fd76d00096292cef0`
MD5	`36656f9032879a50512c7a84a1ce048c`
BLAKE2b-256	`dd85de73aff6c940531856b0fb85ebb37eee6d6f1f1700225778d8c0b79c2031`

Algorithm	Hash digest
SHA256	`80282c304e250009bac118e4a3d10a2b49b5218fd3d6e437cb77fdf3afad0ab2`
MD5	`6c83be1343933bfbbe2dcc0933000f6b`
BLAKE2b-256	`045d9485c93ae1278f162815d02336fb697d741a1f6db1f01df38abad020f6ce`

Algorithm	Hash digest
SHA256	`c3f995f8dd8ab241936a01b523c0c9f6ae37ba6f320ef70ccbd499b0cba2b946`
MD5	`955cb0c228e7b3b72002340169ff318f`
BLAKE2b-256	`a2c6e28d3e6d3dbc957b996c372c01a517130fc995c5205a60e3080d9cef2e96`

rfmux 1.6.0

rfmux

Quick Start

Installation

Interactive GUI

Scripting with Mock Mode

Scripting with CRS Hardware

Documentation

Repository Structure

Contributing & Feedback

Citation

Project links

Key dates

Owner

Credits

GitHub Statistics

Requires

Provides Extra

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`7dcdccb4357a26f15fdae0005caf2e9caf6f0b8f6420379ac546c4e0fe2b9c48`
MD5	`8a190c983147893cd6bb60be5c09ab9b`
BLAKE2b-256	`7caa43a7c63cc06823bfdb68a8c2f3bd76d1aa2268edfa814374013733adac61`

Algorithm	Hash digest
SHA256	`b83dfceba21c787ff27df0c5756ca8837c68716cb153e48e99bea00d9afab287`
MD5	`72c2fc10bfa6ec152f69dc3106125031`
BLAKE2b-256	`0da9610a24f3c886c0f98ff5901da4ed29b56dff357c220459a8acbc7e62f05b`

Algorithm	Hash digest
SHA256	`80b8caaa698c130388832c5380d7c71b11b0996cbf2b981ee827ebfc2c0eae47`
MD5	`a80aede3e84d980b3b47d32f0eca04b6`
BLAKE2b-256	`dbaf503495af5241ea7515c87d691fbd002026e9d9ae62ba7a0452578c88b5c1`

Algorithm	Hash digest
SHA256	`666e465bdec5008c3d8b2d4a78a3e8cd97defed3fdbe5f51e0978efb86d96642`
MD5	`9910d8612c88dce8978bb7b8c70f78a5`
BLAKE2b-256	`c3bcbc47d19b6d8d6c1eb8c6adfdd87abd542519cf36ed63820310f2f95559d4`

Algorithm	Hash digest
SHA256	`b4173eba948c63d6cd2ab37ae05fde0365c84b5326a99f51a861218f4462ad8f`
MD5	`3697eb40abcd7def71cd8e87a7ec3039`
BLAKE2b-256	`f630d64820f45fe5e683c75aeee528089929de21cdd8c7bb69cd74e8f69708e0`

Algorithm	Hash digest
SHA256	`877229d3f274cd2a9a7b60e2b55994bee21a01c590c17c29271d03562c904a0f`
MD5	`9914cd223f1ef91cd15acbca3adedb58`
BLAKE2b-256	`c93ac71b19f69d4caf3b3fb6d4657074c9268737dbb00aa2174e9a61aefe0354`

Algorithm	Hash digest
SHA256	`03938ace0295cb3cf3e6919952bca5a9b61834c6f9b70f4a05e66e3f7037d0ff`
MD5	`790242055bcfb8586c3f43dac64f51a5`
BLAKE2b-256	`3a8e14bbcd470a8486b3ce2c33243f2e97b8c9db555be64f98d4acc00c6eb27d`

Algorithm	Hash digest
SHA256	`3d4c77fdc3d1543d5f8c8275955d331af532a8a25d8f094f8b3f358026157e9f`
MD5	`bf54aff6689a78210e7096b65df83538`
BLAKE2b-256	`0dd1bb6e9f1fa799f3f60ed72ffd42cd75550869c7ecfcee7cfd67414913cbb1`

Algorithm	Hash digest
SHA256	`0753a8272ed3b1bf9ba11db769aa77196d1c2189b2c72db651a6e095e925618a`
MD5	`c7aea1dcdbefc50b38526c60bff0a857`
BLAKE2b-256	`ba6398cb6c2540ef22cd328d8e23fa5f8de1510b058da295ba27b4e95fbaccfd`

Algorithm	Hash digest
SHA256	`c77b3c4ec0751d02fc1aab3ba3a1c48289952c153bd2ac2f0cb160ff3dd17e4e`
MD5	`9c9e6c10bb08f142354d1ea6f539410d`
BLAKE2b-256	`6f421b99b3ec59b2e06456f8e9993b7cce3a77d338722ef6123af50621d15595`