Skip to main content

Auspex RT

Bounding-box object detection. Train on your own boxes, detect boxes. One task, done properly — no segmentation heads, no keypoints, nothing you are not using taking up parameters and compute.

Supported annotation formats: YOLO / Roboflow text, COCO JSON, CVAT-for-images 1.1 XML, Pascal VOC XML — mixed freely in one training run.

Trained from random initialisation. No pretrained weights are downloaded, and none are required: the model is yours from the first step, with no upstream licence attached to it.

Install

pip install auspex-rt        # import name: auspex_rt

Wheels for Linux x86_64, Windows, and macOS Apple Silicon, Python 3.10–3.13. An NVIDIA GPU is recommended for training (precision is picked automatically for your hardware); CPU works for inference.

Use

from auspex_rt import Auspex

model = Auspex(labelspace="labelspace.yaml")
model.train(data="data.yaml", epochs=150)          # train on your own data
results = model.predict("images/", save=True)      # detect

model = Auspex(weights="best.pt")                  # checkpoints are self-contained
model.val(data="data.yaml")

Or the console command: auspex-rt train --data data.yaml --labelspace labelspace.yaml, auspex-rt predict --weights best.pt --source images/, auspex-rt val --weights best.pt --data data.yaml.

Pointing it at a YOLO export

A Roboflow/YOLO export is described by its data.yaml, which is the only file in it that names the classes. Point the parser straight at that:

sources:
  - name: batch1
    path: /datasets/pow/data.yaml   # YOLO data.yaml
    split: train
    provides: {rect: true}

Both YOLO line formats are read: the 5-field box form (cls cx cy w h) and the polygon form (cls x1 y1 … xn yn) that segmentation and oriented-box exports produce. A polygon is converted to its axis-aligned bounding box, and the conversion is counted and warned about — this model detects axis-aligned rectangles, so a polygon carries information it cannot represent, and a silent lossy import is how you conclude the model is broken when the loader threw the shape away.

Pre-labeling workflow

Send model predictions straight back to your labeling tool:

model.predict("images/", export="cvat")     # CVAT-for-images 1.1 XML pre-labels
model.predict("images/", export="coco")     # or COCO JSON
model.predict("huge_scans/", tiles="auto")  # tile very large images so small
                                            # objects stay detectable

Training quality features: a val split in data.yaml enables validation during training (best.pt tracks real validation AP, per-class AP is logged, --patience N stops early); --class-balance oversamples images containing rare classes; auspex-rt calibrate --weights best.pt --data data.yaml stores per-class confidence thresholds in the checkpoint so classes with different score scales all show up at their own best operating point.

Very small objects

If your objects are only a few pixels across at training resolution, the default detection grid (finest stride 8) cannot resolve them. Two options, in a train.yaml:

model:
  strides: [4, 8, 16, 32]   # adds a finer detection level
train:
  micro_batch: 2            # ~4x the anchors; halve the batch at 768 px
augment:
  native_crop_p: 0.5        # or: train on zoomed windows of large source images

Measured on a set where half the objects were smaller than one grid cell, the finer level roughly doubled F1 on the smallest classes. It is a trade, not a free win: long thin objects (road-like lines spanning much of the frame) tend to fragment into several detections, so leave it off for those. Both settings are off by default — check your own box sizes before reaching for them.

Data configuration

labelspace.yaml — your categories, in order; the index is the class id.

data.yaml — one entry per annotation source:

sources:
  - name: batch1
    path: annotations/batch1.xml   # YOLO data.yaml | CVAT 1.1 XML | COCO .json | VOC xml dir
    images_root: images/
    split: train
    provides: {rect: true}

provides: {rect: true} declares that this source actually labels boxes. A source that does not is still useful — its images teach background — but it must not push predictions toward background on classes it never labelled, and this flag is what prevents that.

A dataset annotated with polygons or keypoints still trains a box model: the box is derived from the annotation's extent, so a segmentation set you already own is usable without re-annotation.

Growing a model over time: --transfer <checkpoint> continues from existing weights even when classes were added or reordered; --source-balance rebalances very unequal sources; --cache-records keeps memory flat on large datasets.

Trial and licensing

Training is free for 30 days, in full — no key, no sign-up, no feature limits. The clock starts on your first training run.

Prediction, validation, calibration and export are never gated. They keep working after the trial ends, on any model you have already trained, forever. Evaluating this against your own data does not require buying anything.

After 30 days, training needs a credential. Either kind goes in the same place:

export AUSPEX_RT_LICENSE=AUSPEXRT-...   # a licence key, or
export AUSPEX_RT_LICENSE=HLN1....       # an account token
                                        # or write it to ~/.auspex-rt/license.key
  • A licence key (AUSPEXRT-...) is issued to an organisation for a fixed term. Request one at the link below.
  • An account token (HLN1....) is one you generate yourself, from the console of an account that has been granted access to this package.

Both are verified offline against a public key compiled into the wheel — nothing phones home, so training works on air-gapped machines and this never sits in the critical path of your build. The trade is that neither can be withdrawn before it expires, which is why both are dated.

Get a key: https://heliontechltd.com/license

License

Proprietary software under an End-User License Agreement: licensed users may install and run Auspex RT and train models on their own data (the resulting weights are theirs); copying, redistribution, modification, and reverse engineering are prohibited. See https://heliontechltd.com/license for terms and licensing inquiries.

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

auspex_rt-0.1.0-cp313-cp313-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.13Windows x86-64

auspex_rt-0.1.0-cp313-cp313-win32.whl (1.6 MB view details)

Uploaded CPython 3.13Windows x86

auspex_rt-0.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (13.5 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

auspex_rt-0.1.0-cp313-cp313-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

auspex_rt-0.1.0-cp312-cp312-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.12Windows x86-64

auspex_rt-0.1.0-cp312-cp312-win32.whl (1.6 MB view details)

Uploaded CPython 3.12Windows x86

auspex_rt-0.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (13.9 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

auspex_rt-0.1.0-cp312-cp312-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

auspex_rt-0.1.0-cp311-cp311-win_amd64.whl (1.9 MB view details)

Uploaded CPython 3.11Windows x86-64

auspex_rt-0.1.0-cp311-cp311-win32.whl (1.7 MB view details)

Uploaded CPython 3.11Windows x86

auspex_rt-0.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (13.4 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

auspex_rt-0.1.0-cp311-cp311-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

auspex_rt-0.1.0-cp310-cp310-win_amd64.whl (1.9 MB view details)

Uploaded CPython 3.10Windows x86-64

auspex_rt-0.1.0-cp310-cp310-win32.whl (1.7 MB view details)

Uploaded CPython 3.10Windows x86

auspex_rt-0.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.6 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

auspex_rt-0.1.0-cp310-cp310-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

File details

Details for the file auspex_rt-0.1.0-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 621a1b5ed37003f9a1b3a4b2979621cb800b5b424390569ed27e6e28621949eb
MD5 e50b7294d75e80c79620f659e1f69214
BLAKE2b-256 0cbed73586d3431f4c7509b82bf0c4e63ea586c9603d3428bc0774991af1f02e

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp313-cp313-win_amd64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp313-cp313-win32.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp313-cp313-win32.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.13, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp313-cp313-win32.whl
Algorithm Hash digest
SHA256 69d85620fecb2ca02872b46953232828f59e84293742a0d7585e27c26a5fd68f
MD5 98237aa3f52418256f8bb2aab830db54
BLAKE2b-256 e71d3c82def931037f5b6f05a2f89a4b88175f0ef397b8f0f9eb738027fafc44

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp313-cp313-win32.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7079c55056c0db3d91c8ae473b37b93550cf2cafc8c93baa91960d714aa7da91
MD5 f20f3042d69febbfaef39bab8c57389e
BLAKE2b-256 8a1360baef9189d3e4c13f41c4699d53c94b772dee8fa419155730726c0ea37c

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b0ebac8b0bb8499ae426f1b6b92fc7e12103f90000afe2abe672243d823f4233
MD5 0806b6a1532e04ffbb647557082703ba
BLAKE2b-256 421376f5af21098c08f060424e976aafd0f44a076e7278bea1bcc95946d6bd75

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 c67879108b3d91a2caa3791881129fffa6ee6f2279fc342e3fd280c5146686b8
MD5 4ac515f81679ce0a8f6e2fc2786431dd
BLAKE2b-256 f769ecb69835027203496245011d942a29f36fb123f5e85620302ea2a0b9f64e

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp312-cp312-win_amd64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp312-cp312-win32.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp312-cp312-win32.whl
  • Upload date:
  • Size: 1.6 MB
  • Tags: CPython 3.12, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp312-cp312-win32.whl
Algorithm Hash digest
SHA256 f0a66bac4ccff24504de6e90d68e40d5f51446532de0f64bb4ef1e4a91ea0e2a
MD5 abf0b94103c4209946eaf6017077afc8
BLAKE2b-256 0fc2360fadd86f19ccf1b368d08acb32ee5d9074570557148fb660b95074b4c4

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp312-cp312-win32.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 4b7bc02f89ced5ade086303ee302d5a6d4d5ea202c4217a24a1bf81bed746752
MD5 6363be7e5f6b6943204d0c9df4746ff0
BLAKE2b-256 ea3462a2f01bb9ecdb4ec4b0c2b06ace31e89041d4377e8711156efb0860dbd6

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 690bae74837faccb68b16bbab8172fdab76e563c5ba0eb4e11d66d8403fa18c9
MD5 22ee3d399d9e6d2b16fa524d8db2f07b
BLAKE2b-256 64dd2c6679d91e5fe9f5be9ddb50639446b752d632f5b5f9b62045461ad68f25

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 8f56975d7d8916aa9985ab3593e9d03021bdb143f25c9f76702036a54fb3b568
MD5 08257a76fd23c804184f897c757d83dd
BLAKE2b-256 8e044a90457b306f1aba217a4aa0808f1ed130292e5676f67f1ae249f775977e

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp311-cp311-win_amd64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp311-cp311-win32.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp311-cp311-win32.whl
  • Upload date:
  • Size: 1.7 MB
  • Tags: CPython 3.11, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp311-cp311-win32.whl
Algorithm Hash digest
SHA256 740b24fd4b3eb21a15dd9a7cf5317c343631fee5bba786bacd9bb26c0dd25f31
MD5 8a4d52d514d862f92cd6141fba51fa12
BLAKE2b-256 464574efafd5b699256853bc78791e5c1cf0706fc329c34a6724c7e554dc2345

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp311-cp311-win32.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ac330faab8b9ee5a0ad81bb076ec8f057c0fdb51c43c664dccd86ff27daccd95
MD5 92afeb3a067806165e84022b65cd7d71
BLAKE2b-256 d216a7334c8c0bf6c66772af526050798dea62d3ec8a046d0849ef600b503d83

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5777cf305784975dc92e6cad610836dd3a55a12b301d35b6f59fee2fd71582d1
MD5 bbbdefc9da7954b7116827c7d48d7f8f
BLAKE2b-256 231505f4146905b483d3889bb70452272a399c81198e150de10c3eb7775764e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 4c4e84cf02a3df9497618089c7d2f647abe087fc68d6c7795465327679f90719
MD5 32c3a8d45b19239ff05e6513f2823121
BLAKE2b-256 7a71e8b5d7f17cff1751f3f6dc0e16741035b1d72cd2876978cdcd6dccc1f853

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp310-cp310-win_amd64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp310-cp310-win32.whl.

File metadata

  • Download URL: auspex_rt-0.1.0-cp310-cp310-win32.whl
  • Upload date:
  • Size: 1.7 MB
  • Tags: CPython 3.10, Windows x86
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for auspex_rt-0.1.0-cp310-cp310-win32.whl
Algorithm Hash digest
SHA256 eb2a7c0667297d0d44ccbf579466b4e7c0310caf27ea942851f0e70013f21586
MD5 95d5998dd041a80f06e545101dd13bf8
BLAKE2b-256 d7ecb286570470e0e1fc48328d866a51ccb0c0f9c2b02645ff1b280b8c7d094a

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp310-cp310-win32.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 0801fe9564c9457389b0aceab00770e818ead213937625caa9dc766e0f8efa03
MD5 affc4c46e59b35bbd2fea4a37d2c0153
BLAKE2b-256 f8eb22c5ae5c04a980b1ec3fcbfd583ee0dc9997ae27b37148c4045596e2821c

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file auspex_rt-0.1.0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for auspex_rt-0.1.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 504cc48dcf4af8388bc7d517e70e0bde928ffafa90ba8d7ff2e0c59c5a0f9e66
MD5 00d0c80ad9b3f12b6936ef1508ae0cc8
BLAKE2b-256 158a9ba71efca0893fde1007b8766e20e2f49a90511ada599e7da226ec145972

See more details on using hashes here.

Provenance

The following attestation bundles were made for auspex_rt-0.1.0-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: wheels.yml on sohanurislamshuvo/auspex-rt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page