karung-counting-feedmill-semarang/docs/scripts.md

Scripts reference

Entry points

• predict.py — single entrypoint: production service (zero flags) + dev CLI. Combined sack+truck model + repo src/ modules, shapely zones, visual-similarity/Re-ID debounce, SQLite, live-frame publish. Run by karung-counter.service. Flags: --source/--env/--config/--model/--model-mode/ --output-dir/--output-json/--sack-conf/--truck-conf/--box-conf/--box-model/ --batch-timeout/--max-frames/--no-dashboard/--no-db (see predict.py --help). Config: config.yaml (canonical) + .env (secrets/deployment).
• src/main.py — deprecated shim: prints a pointer to predict.py, still runs the old v3 loop for backward compat.
• archive/ — retired: predict_new.py (duo-model state machine), rpo_iki/ (alternate geometric engine + predict_rpo_iki.py), simple_predict.py (minimal CPU demo), ini.py, check/merge/test scripts. Not imported anywhere.

Calibration & data tools

• archive/get_coordinates.py / archive/get_calib_frame.py — zone calibration (calib_frame.jpg, zones.json); archive/capture_frame_native.py — grab native frames (live_frame_native.png).
• extract_random_frames.py — sample frames for labeling; archive/check_*.py (check_20_23, check_20_aug, check_all_after) — batch verification passes.
• archive/test_bytetrack.py, archive/test_track_crash.py — tracker experiments/crash repro.

DB / ops helpers

counter_dashboard.py (dashboard), check_jetson_db.py, archive/backup.py, archive/dump_db.py, archive/migrate_jetson_db.py, archive/merge_batches_20_23.py, archive/merge_batches_28_35.py, archive/update_batches.py, archive/diagnose_truck_jetson.py, deploy_to_jetson.py, export_model.py / archive/export_v4.py (TensorRT export).

Ignored at runtime (.gitignore)

.env, *.db, state JSONs, batch_history_folder/, media (*.mp4/*.jpg/*.png), *.engine (rebuildable via export_model.py), venvs, IDE files — so the large weights, videos and local DBs in this working tree are intentionally untracked. (models/*.pt/*.onnx ARE tracked so clones are inference-ready.)