{"id":25204390,"url":"https://github.com/pyronear/pyro-envdev","last_synced_at":"2026-02-13T23:10:50.480Z","repository":{"id":103728878,"uuid":"354314945","full_name":"pyronear/pyro-envdev","owner":"pyronear","description":"Deployment and infrastructure management","archived":false,"fork":false,"pushed_at":"2026-02-06T22:02:05.000Z","size":145,"stargazers_count":1,"open_issues_count":6,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-02-06T22:16:14.983Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","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":"2021-04-03T14:38:13.000Z","updated_at":"2026-02-06T22:02:11.000Z","dependencies_parsed_at":"2025-01-29T16:22:27.053Z","dependency_job_id":"c66a4228-0647-47f0-b057-dbd6b6f10985","html_url":"https://github.com/pyronear/pyro-envdev","commit_stats":{"total_commits":2,"total_committers":2,"mean_commits":1.0,"dds":0.5,"last_synced_commit":"20f6a66888567798a5d29bb94422cbdee5481c76"},"previous_names":["pyronear/pyro-envdev"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pyronear/pyro-envdev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Fpyro-envdev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Fpyro-envdev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Fpyro-envdev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Fpyro-envdev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyronear","download_url":"https://codeload.github.com/pyronear/pyro-envdev/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyronear%2Fpyro-envdev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29422586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T22:20:51.549Z","status":"ssl_error","status_checked_at":"2026-02-13T22:20:49.838Z","response_time":78,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2025-02-10T08:17:39.550Z","updated_at":"2026-02-13T23:10:50.474Z","avatar_url":"https://github.com/pyronear.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pyronear Dev Environment\n\nThis repository provides a Docker Compose configuration to run a full Pyronear development environment with the API, database, S3 emulation, frontend, notebooks, and optional camera engine.\n\n---\n\n## ⚙️ Installation\n\n### Prerequisites\n\n* Docker and Docker Compose\n* Add this line to `/etc/hosts` so the MinIO endpoint resolves correctly:\n\n  ```\n  127.0.0.1 minio\n  ```\n\n---\n\n## 🚀 Quick Start\n\n### Init\n\n```bash\nmake init\nmake build\n```\n\n### Run\n\n```bash\nmake run\n```\n\n* Send an alert by opening [http://0.0.0.0:8889/notebooks/notebooks/send_real_alerts.ipynb](http://0.0.0.0:8889/notebooks/notebooks/send_real_alerts.ipynb)\n* Observe the alert on the frontend at [http://0.0.0.0:8050/](http://0.0.0.0:8050/)\n* Use credentials from `data/csv/API_DATA_DEV/users.csv`\n* Or check directly on the API at [http://0.0.0.0:5050/docs](http://0.0.0.0:5050/docs) with the same creds\n\n---\n\n## 🧩 Services\n\n* **pyro-api**: Pyronear API (uvicorn)\n* **db**: PostgreSQL database\n* **minio**: S3-compatible storage (via MinIO)\n* **frontend**: Web app (Dash)\n* **pyro-engine**: Engine service (requires cameras, optional)\n* **reolinkdev1 / reolinkdev2**: Fake Reolink cameras sending test images\n* **notebooks**: Jupyter server to run helper notebooks\n* **db-ui**: pgAdmin to browse/manage the database\n\n---\n\n## ▶️ Running\n\n### Full stack with engine\n\n```bash\nmake build\nmake run-all\n```\n\nThis launches everything including the engine and simulated alerts.\nYou can check health with:\n\n```bash\ndocker logs init\ndocker logs engine\n```\n\n### Partial runs\n\n* Backend only (API, DB, S3):\n\n  ```bash\n  make run-backend\n  ```\n* Engine only:\n\n  ```bash\n  make run-engine\n  ```\n* Tools only (notebooks, db-ui):\n\n  ```bash\n  make run-tools\n  ```\n\n---\n\n## 🔑 Access\n\n* **API**: [http://localhost:5050/docs](http://localhost:5050/docs)\n* **Frontend (Dash app)**: [http://localhost:8050](http://localhost:8050)\n\n  * If issues: use a private browser window\n  * Admin access currently does not display camera alerts, use user creds from `data/csv/users.csv`\n* **Notebooks**: [http://localhost:8889](http://localhost:8889)\n* **pgAdmin (db-ui)**: [http://localhost:8888/browser/](http://localhost:8888/browser/)\n\n  * Login: `DB_UI_MAIL` / `DB_UI_PWD` (set in `.env`)\n  * First connection: register server with host `db`, user/password from `.env`\n* **MinIO console (S3 GUI)**: [http://localhost:9001](http://localhost:9001)\n\n  * Manage buckets, upload/delete files\n\n---\n\n## 📂 Data Usage\n\n### Add more images to Reolink Dev\n\nCreate a directory `data/images` before starting the environment and put your images inside.\n\n### Send custom alerts\n\nUse Jupyter notebooks (e.g., `notebooks/send_real_alerts.ipynb`).\nWhen running notebooks **inside Docker**, set:\n\n```python\nAPI_URL = \"http://api:5050\"\n\n### Update the last image for a camera\n\n1. Upload a new image in MinIO under the bucket ending with `...-alert-api-{organisation_id}`\n2. In pgAdmin, update the `cameras` table:\n\n   * `last_image` with the filename\n   * `last_active_at` timestamp\n\n\n```\n\n---\n\n## 🛑 Cleanup\n\nStop and remove everything:\n\n```bash\nmake stop\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyronear%2Fpyro-envdev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyronear%2Fpyro-envdev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyronear%2Fpyro-envdev/lists"}