{"id":50687456,"url":"https://github.com/pyronear/temporal-model","last_synced_at":"2026-06-09T00:02:32.652Z","repository":{"id":362096628,"uuid":"1257193258","full_name":"pyronear/temporal-model","owner":"pyronear","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-02T16:07:00.000Z","size":173,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T16:10:56.360Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pyronear.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-02T12:58:35.000Z","updated_at":"2026-06-02T14:31:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pyronear/temporal-model","commit_stats":null,"previous_names":["pyronear/temporal-model"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/pyronear/temporal-model","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Ftemporal-model","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Ftemporal-model/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Ftemporal-model/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Ftemporal-model/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyronear","download_url":"https://codeload.github.com/pyronear/temporal-model/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Ftemporal-model/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34085321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-09T00:02:28.352Z","updated_at":"2026-06-09T00:02:32.644Z","avatar_url":"https://github.com/pyronear.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🕐🔥 temporal-model\n\nMonolithic repository for the Pyronear **temporal smoke classifier**:\ntrain it, evaluate it, and serve it behind an API.\n\nThe model is a per-tube smoke classifier: a YOLO detector proposes boxes, boxes\nare linked into temporal tubes (greedy IoU), each tube's frames are cropped to\n224×224 patches and scored by a **ViT (DINOv2) backbone + transformer head**\nthat emits one logit per tube.\n\n## Packages\n\nFour independent packages, each with its own `pyproject.toml` and `tests/`.\n\n| Path | Import | Purpose |\n|------|--------|---------|\n| `core/`  | `temporal_model.core`  | Model, tube building, patch extraction, inference, packaging. |\n| `train/` | `temporal_model.train` | DVC training pipeline. Depends on `core`. |\n| `eval/`  | `temporal_model.eval`  | DVC evaluation pipeline (packaged-model protocol metrics). Depends on `core`. |\n| `api/`   | `temporal_model.api`   | FastAPI serving layer, shipped as a Docker service. Depends on `core`. |\n\n`train`/`eval`/`api` depend on `core` via a `uv` path source\n(`temporal-model-core = { path = \"../core\", editable = true }`). `core` and\n`train` pull in PyTorch / timm / ultralytics, so their first `uv sync` is large.\n\n## Quick start\n\n```bash\nmake install        # uv sync across all four packages\nmake test           # pytest across all four packages\nmake lint           # ruff check across all four packages\n```\n\nPer package, `cd \u003cpkg\u003e \u0026\u0026 make install|lint|format|test`.\n\n### Run the API locally (Docker)\n\n```bash\nmake serve      # API + MinIO via docker compose, http://localhost:8000 (GET /health)\n```\n\nEquivalent to `cd api \u0026\u0026 docker compose up --build`. The compose stack ships\nlocal-dev MinIO defaults (bucket `frames`, `minioadmin` creds); drop a\n`model.zip` under `api/models/` for `/health` to report `model_loaded: true`.\n\n## Origin\n\nPorted from the Pyronear [`vision-rd`](https://github.com/pyronear/vision-rd)\nresearch repo's `bbox-tube-temporal` work:\n\n- `core/` — from [`lib/bbox-tube-temporal`](https://github.com/pyronear/vision-rd/tree/main/lib/bbox-tube-temporal)\n- `train/` and `eval/` — from [`experiments/temporal-models/bbox-tube-temporal`](https://github.com/pyronear/vision-rd/tree/main/experiments/temporal-models/bbox-tube-temporal)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyronear%2Ftemporal-model","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyronear%2Ftemporal-model","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyronear%2Ftemporal-model/lists"}