Skip to main content

An orchestrated SDR scanner

Project description

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

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:latest
  • docker build -f Dockerfile . -t iqtlabs/gamutrf:latest

Project details


Download files

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

Source Distribution

gamutrf-0.5.71.tar.gz (26.5 kB view details)

Uploaded Source

Built Distribution

gamutrf-0.5.71-py3-none-any.whl (31.6 kB view details)

Uploaded Python 3

File details

Details for the file gamutrf-0.5.71.tar.gz.

File metadata

  • Download URL: gamutrf-0.5.71.tar.gz
  • Upload date:
  • Size: 26.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.10.12 Linux/6.5.0-1025-azure

File hashes

Hashes for gamutrf-0.5.71.tar.gz
Algorithm Hash digest
SHA256 0ddc491ef2f0ed53091afe8dd2f862a7bf5895e27aa19f0d4c9eb4c5ca61e5f8
MD5 5b93d369662fb3795d155023ea0311d2
BLAKE2b-256 6043675436c552b2bbab95de0ed46c5b836e1ca7b5319d9f0f2bdb530314f05f

See more details on using hashes here.

File details

Details for the file gamutrf-0.5.71-py3-none-any.whl.

File metadata

  • Download URL: gamutrf-0.5.71-py3-none-any.whl
  • Upload date:
  • Size: 31.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.10.12 Linux/6.5.0-1025-azure

File hashes

Hashes for gamutrf-0.5.71-py3-none-any.whl
Algorithm Hash digest
SHA256 0ab33bb2a8285ca0493bae8cab574c80964fd3e11493cf9d112c393aac7703a5
MD5 6d577bddeb726fb5ec1504164c49ed4b
BLAKE2b-256 7ed9a9a3455e1260889611dc84c76a56411865a4abfd73ee4371291c5bef61f8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page