CLI reference¶

manage.py commands for Trapper Expert. Run inside the container:

docker compose exec trapper bash
python /app/trapper-project/manage.py <command> [args]

…or via trapper-setup:

./admin.py manage trapper <command> -p <profile> -- [args]

For trapper-setup's own CLI (configure.py, admin.py) see Deploy with trapper-setup. For trapper-tools, see its own docs (linked from Convert, package & upload with Trapper-Tools).

Taxonomy¶

import_gbif_taxonomy : Import species from the bundled GBIF Backbone CSVs. Idempotent.

python manage.py import_gbif_taxonomy --taxa mammalia aves --mode create
python manage.py import_gbif_taxonomy --taxa mammalia --mode update --dry-run

add_gbif_override : Append manual taxonomy overrides by querying the GBIF API.

python manage.py add_gbif_override mammalia "Bison bonasus,Lynx lynx"

AI / model sync¶

sync_ai_models : Pull the AI Manager's prediction-model catalog + bundled trapper-schemas category YAMLs, create/update AIProvider rows, resolve gbifSpeciesKey → Species.taxon_id for every species AttributeLabel. Idempotent.

python manage.py sync_ai_models

!!! note
    `sync_ai_models` does **not** download model weights — that's the AI Worker coordinator's job, driven by `model_manifest.yaml`.

Classifications¶

rebuild_classification_msgpacks : Regenerate Classification.frames_msgpack files from source data — images from the dyn_attrs JSON columns, videos from the project's ObjectFrameObservation hypertable (only with --include-videos; the hypertable must already be populated for that project).

python manage.py rebuild_classification_msgpacks --project 42
python manage.py rebuild_classification_msgpacks --project 42 --force --include-videos
python manage.py rebuild_classification_msgpacks --classification 12345
python manage.py rebuild_classification_msgpacks --all-projects --dry-run

Hypertable¶

configure_hypertable : Inspect/tune the TimescaleDB hypertable backing ObjectFrameObservation. Safe to re-run.

python manage.py configure_hypertable --show
python manage.py configure_hypertable --chunk-interval "30 days"
python manage.py configure_hypertable --compress-after "60 days"
python manage.py configure_hypertable --compress-segmentby "project_id,classification_id"
python manage.py configure_hypertable --chunk-interval "30 days" --compress-after "14 days" --dry-run

populate_project_hypertable : Populate a project's ObjectFrameObservation snapshot from its classifications' existing msgpack files, downsampled to a target fps. Tracked per-project via ProjectHypertablePopulation.status.

python manage.py populate_project_hypertable --project 42
python manage.py populate_project_hypertable --project 42 --fps 5 --sync
python manage.py populate_project_hypertable --all-projects --fps 1

Data lifecycle¶

generate_thumbnails : Generate/regenerate thumbnail and preview images for resources. Multi-threaded; safe to run on a live system.

python manage.py generate_thumbnails --all
python manage.py generate_thumbnails --missing both --threads 8
python manage.py generate_thumbnails --filter "project_id=7" --dry-run

extract_metadata : Extract/parse media metadata (EXIF, container timestamps) for uploaded resources. Often the first remediation step when a batch of files came in without correct timestamps.

python manage.py extract_metadata --projects 7 --run --parse-timestamps
python manage.py extract_metadata --videos-only --max-workers 4
python manage.py extract_metadata --filter "deployment_id=42" --update-deployment

delete_orphaned : Find and delete media files on disk not referenced by any Resource row. Use after manually deleting Resources or recovering from a partial restore.

python manage.py delete_orphaned --info     # dry-run report
python manage.py delete_orphaned            # actually delete

Server¶

start_uploader_server : Start the chunked-HTTP-upload FastAPI service (the Compose trapper_uploader container runs this). Listens on 0.0.0.0:8088 by default. Only run manually when developing the uploader code outside Compose.

python manage.py start_uploader_server

Admin actions reference¶

Every admin action in the Expert backend (/admin/), grouped by app.

accounts

common

storage

media_classification

geomap

extra_tables