{"id":22969694,"url":"https://github.com/dy0gu/firewatcher","last_synced_at":"2026-05-14T17:12:40.494Z","repository":{"id":51607020,"uuid":"516006303","full_name":"dy0gu/firewatcher","owner":"dy0gu","description":"Discord bot providing information on active wildfires in Portugal.","archived":false,"fork":false,"pushed_at":"2024-06-21T23:50:10.000Z","size":90,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-14T19:09:02.172Z","etag":null,"topics":["bot","discord"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dy0gu.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},"funding":{"github":"dy0gu","patreon":"dy0gu"}},"created_at":"2022-07-20T14:05:00.000Z","updated_at":"2024-07-13T23:07:16.000Z","dependencies_parsed_at":"2024-03-09T01:24:37.400Z","dependency_job_id":"54d9f49f-6167-4b16-aa9d-36beaebec1c4","html_url":"https://github.com/dy0gu/firewatcher","commit_stats":null,"previous_names":["dy0gu/firewatcher"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dy0gu%2Ffirewatcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dy0gu%2Ffirewatcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dy0gu%2Ffirewatcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dy0gu%2Ffirewatcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dy0gu","download_url":"https://codeload.github.com/dy0gu/firewatcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229759827,"owners_count":18119871,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bot","discord"],"created_at":"2024-12-14T21:37:37.809Z","updated_at":"2026-05-14T17:12:35.472Z","avatar_url":"https://github.com/dy0gu.png","language":"Python","funding_links":["https://github.com/sponsors/dy0gu","https://patreon.com/dy0gu"],"categories":[],"sub_categories":[],"readme":"# Wildfire info with discord! 🔥ℹ️\n\n![logo](src/assets/logo.png)\n\nFirewatcher gets its data from the [fogos.pt](https://fogos.pt/) API and is mostly a simple wrapper around it. Due to the nature of the API, the bot is only able to provide information about wildfires in Portugal.\n\n## Usage 🔦\n\nThis bot can be added to discord servers through the following [link](https://discord.com/oauth2/authorize?client_id=999712607227359274\u0026permissions=0\u0026scope=bot).\n\n## Development 🛠️\n\n- ### Requirements 📋\n\n  - Python ([version](pyproject.toml#L5))\n\n- ### Setup ⚙️\n\n  - Clone the repository and open a terminal **inside** it.\n\n  - Install the dependencies:\n\n    ```shell\n    # Creating a virtual environment is recommended before installing any project dependencies!\n\n    pip install .\n    ```\n\n- Create a `.env` file based on the [`.env.example`](.env.example) file.\n\n  - Start the app:\n\n    ```shell\n    python src/bot.py\n    ```\n\n- ### Tooling 🧰\n\n  - Ruff is used as a linter and formatter:\n\n    ```shell\n    pip install .[check]\n    ruff check --fix\n    ruff format\n\n    # To automatically lint and format on every commit install the pre-commit hooks:\n    pre-commit install\n\n    # When using pre-commit hooks, commits may fail if files with errors are checked.\n    # Changed files must be added to the staged area and commited again to apply fixes.\n    # If you run into any issues just manually run the linter commands above to address them.\n    ```\n\n## Deployment 🚀\n\nThe bot is automatically built by a pipeline with every release, so a **Docker** image is available in the **Packages** section of the repository. The build images are also published on Docker Hub.\n\n- Supply the [required environment variables](.env.example) when running the container, just like in development.\n\n- Start the container using the provided `docker-compose.yaml`:\n\n  ```shell\n  # The example compose will try to pull from the registry first, and only builds on fails.\n  # To force a build first, simply remove the image key from the service definition.\n\n  docker compose up --build --force-recreate --detach --wait --wait-timeout 120\n  ```\n\n- Serve it using your server configuration of choice!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdy0gu%2Ffirewatcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdy0gu%2Ffirewatcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdy0gu%2Ffirewatcher/lists"}