gamutRF
gamutRF is a gnuradio-based SDR-based scanner, I/Q signal collector and identifier (using a image or I/Q based pyTorch model).
While it can run on Pi4 and Pi5 machines (and its components can be distributed over a network), it is more typically deployed on a single x86_64 machine with an nvidia GPU (see deployment instructions).
gamutRF's scanner container connects to a local SDR and sweeps over a configured frequency range or ranges collecting samples. When a configurable number of valid I/Q samples are received the SDR is retuned to a new interval (see blocks in gr-iqtlabs). The samples are processed and sent to a waterfall container for display, and optionally to a Torchserve instance for identification. Recording, and basic parameters (such as the frequency range to scan) can be controlled from the waterfall container.
License
Distributed under the Apache 2.0. See LICENSE for more information.
Contact IQTLabs
- Twitter: @iqtlabs
- Email: info@iqtlabs.org
See our other projects: https://github.com/IQTLabs/
AIR-T support
GamutRF has legacy support for the Deepwave AIR-T
Development
Development with GamutRF requires familiarity with gnuradio, an SDR, a x86_64 host running Ubuntu 24.04 with Docker installed (and ideally an nvidia GPU, though this is not required).
Local development
- Install gnuradio, 3.10 or later
- Install gr-iqtlabs
- Make modifications, and install with
poetry install - Run tests with
pytest
Docker development
Follow above local development instructions, and then build containers (tests will be run inside the containers).
docker build -f docker/Dockerfile.base docker -t iqtlabs/gamutrf-base:latestdocker build -f Dockerfile . -t iqtlabs/gamutrf:latest
1 maintainer
Metadata
1 maintainer
Release files for gamutrf 0.5.72
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gamutrf-0.5.72.tar.gz | 26.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gamutrf-0.5.72-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.6 kB
Release files / gamutrf-0.5.72.tar.gz
| Download URL | gamutrf-0.5.72.tar.gz |
|---|---|
| Size | 26.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f9c774d4c42fca85324efa6c8d8204d62c99cd8006da5e1018c3427460ec3217
|
|
BLAKE2b-256 checksum How to use checksums |
0913fbb901a52dcd10c7e47e9e1c830a867aece8326ddc6241f12c75ae81c333
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.4 CPython/3.12.3 Linux/6.11.0-1018-azure
|
Release files / gamutrf-0.5.72-py3-none-any.whl
| Download URL | gamutrf-0.5.72-py3-none-any.whl |
|---|---|
| Size | 31.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
63cd2cd912cad4059cf7ffa02c3fc5c210061b1a4532bf6aa1e0f0c7b56b9354
|
|
BLAKE2b-256 checksum How to use checksums |
02896a9f4d4d2e13a429eab14d766ff395ba766ccc3238bf4fe6171251e165b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.4 CPython/3.12.3 Linux/6.11.0-1018-azure
|
