[ENVIRONMENT] Wildfire Environment to simulate Wildfires for OpenEnv (FastAPI, RL-compatible) #108

shankerram3 · 2025-10-28T01:54:49Z

No description provided.

meta-cla · 2025-10-28T01:54:54Z

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at [email protected]. Thanks!

meta-cla · 2025-10-28T02:13:57Z

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

Updated README with sample rendering code for wildfree simulation.

Added sections on wildfire simulation motivation, research goals, and citations to the README.

Copilot

Pull Request Overview

This PR introduces a new wildfire simulation environment to the OpenEnv framework. The environment models fire spread dynamics influenced by wind, humidity, and limited resources (water and firebreaks), enabling RL agents to learn fire containment strategies.

Key Changes

Implements WildfireEnvironment with physics-based fire spread mechanics including wind direction effects, humidity suppression, and multi-tick burn lifetime
Adds Docker containerization support with build scripts and Dockerfile for deployment
Provides client-side API with visualization utilities for rendering the grid state

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
`src/envs/wildfire_env/server/wildfire_environment.py`	Core server implementation with fire spread logic, reward shaping, and action handling
`src/envs/wildfire_env/models.py`	Data models for actions, observations, and state
`src/envs/wildfire_env/client.py`	HTTP client implementation with grid rendering utility
`src/envs/wildfire_env/server/app.py`	FastAPI application entry point
`src/envs/wildfire_env/server/Dockerfile`	Docker container configuration
`src/envs/wildfire_env/server/build_docker.sh`	Docker build script
`src/envs/wildfire_env/README.md`	Comprehensive documentation with usage examples
`src/envs/wildfire_env/__init__.py`	Package initialization and exports
`src/envs/wildfire_env/server/__init__.py`	Server package initialization

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-10-31T00:33:11Z

src/envs/wildfire_env/server/wildfire_environment.py

+           # --- Required abstract property implementation ---
+    @property
+    def state(self) -> WildfireState:
+     """Return the current environment state."""
+     return self._state


Inconsistent indentation detected. Lines 364-368 have mixed indentation levels. Line 364 has excessive leading whitespace, line 367 has only 1 space of indentation instead of the expected 8 spaces for a method body. Standardize to use consistent 4-space indentation throughout.

Suggested change

# --- Required abstract property implementation ---

@property

def state(self) -> WildfireState:

"""Return the current environment state."""

return self._state

# --- Required abstract property implementation ---

@property

def state(self) -> WildfireState:

"""Return the current environment state."""

return self._state

Copilot · 2025-10-31T00:33:11Z

src/envs/wildfire_env/models.py

+    burned_count: int               # total ash (0) cells (cumulative)
+    reward_hint: float = 0.0
+    remaining_water: int = 0
+    remaining_breaks: int = 0# optional shaping info


The comment '# optional shaping info' on line 28 is misplaced. It should be on line 26 or 27, or removed entirely since it doesn't accurately describe the resource fields on lines 27-28. The comment appears to be a leftover from line 26's reward_hint field.

Suggested change

remaining_breaks: int = 0# optional shaping info

remaining_breaks: int = 0

Copilot · 2025-10-31T00:33:11Z

src/envs/wildfire_env/client.py

+    rows = []
+    for y in range(h):
+        rows.append("".join(legend.get(g[y*w+x], "?") for x in range(w)))
+    meta = f"step={obs.step} wind={obs.wind_dir} hum={obs.humidity:.2f} burning={obs.burning_count} burned=         {obs.burned_count}"


Excessive whitespace after 'burned=' creates inconsistent spacing in the output string. Replace the multiple spaces with a single space for consistent formatting.

Suggested change

meta = f"step={obs.step} wind={obs.wind_dir} hum={obs.humidity:.2f} burning={obs.burning_count} burned= {obs.burned_count}"

meta = f"step={obs.step} wind={obs.wind_dir} hum={obs.humidity:.2f} burning={obs.burning_count} burned= {obs.burned_count}"

Copilot · 2025-10-31T00:33:12Z

src/envs/wildfire_env/client.py

+        )
+
+    def _parse_state(self, payload: dict) -> WildfireState:
+        return WildfireState(**payload)


Missing blank lines before function definition. PEP 8 requires two blank lines before top-level function definitions. Add a blank line between line 18 and line 19.

Suggested change

return WildfireState(**payload)

return WildfireState(**payload)

Copilot · 2025-10-31T00:33:12Z

src/envs/wildfire_env/README.md

+```
+
+---
+## Sample rendering to see wildfree simulation


Corrected spelling of 'wildfree' to 'wildfire'.

Suggested change

## Sample rendering to see wildfree simulation

## Sample rendering to see wildfire simulation

Copilot · 2025-10-31T00:33:12Z

src/envs/wildfire_env/server/.ipynb_checkpoints/wildfire_environment-checkpoint.py

@@ -0,0 +1,321 @@
+import os
+import random, uuid
+from typing import List


Import of 'List' is not used.

Suggested change

from typing import List

Copilot · 2025-10-31T00:33:12Z

src/envs/wildfire_env/server/.ipynb_checkpoints/wildfire_environment-checkpoint.py

+from dataclasses import replace
+


Import of 'replace' is not used.

Suggested change

from dataclasses import replace

Copilot · 2025-10-31T00:33:13Z

src/envs/wildfire_env/server/wildfire_environment.py

+
+import os
+import random, uuid
+from typing import List


Import of 'List' is not used.

Suggested change

from typing import List

Copilot · 2025-10-31T00:33:13Z

src/envs/wildfire_env/server/wildfire_environment.py

+import os
+import random, uuid
+from typing import List
+from dataclasses import replace


Import of 'replace' is not used.

Suggested change

from dataclasses import replace

Darktex

Wowwww this is soo cool!!! Thank you for the contribution :)

I can see a few small things that we should change, but otherwise we are almost ready to land.

Also, could you add an example? examples/wildfire.py would be awesome...

Darktex · 2025-10-31T00:57:22Z

src/envs/wildfire_env/server/.ipynb_checkpoints/app-checkpoint.py

@@ -0,0 +1,10 @@
+# server/app.py


Wait, what does this directory do? .ipynb_checkpoints doesn't look like a directory that you wanna check in! :D

Darktex · 2025-10-31T01:00:01Z

src/envs/wildfire_env/README.md

+
+from IPython.display import clear_output, display 
+import matplotlib.colors as mcolors
+sys.path.append("/workspace/OpenEnv/src")


Hardcoded path

Darktex · 2025-10-31T01:00:50Z

src/envs/wildfire_env/server/app.py

+from ..models import WildfireAction, WildfireObservation
+from .wildfire_environment import WildfireEnvironment
+
+W = int(os.getenv("WILDFIRE_W", "16"))


The naming is inconsistent, because in wildfire_environment.py you actually use WILDFIRE_WIDTH. Same thing for height

Darktex · 2025-10-31T01:01:23Z

src/envs/wildfire_env/README.md

+from envs.wildfire_env.server.wildfire_environment import WildfireEnvironment
+
+
+client = WildfireEnv("http://localhost:8020")


Let's use port 8000 for these examples

Darktex · 2025-10-31T01:01:43Z

src/envs/wildfire_env/README.md

+    time.sleep(0.3) 
+
+
+    res = client.step(WildfireAction(action="WAIT"))


The actual action is lowercase "wait" though

Darktex · 2025-10-31T01:02:25Z

src/envs/wildfire_env/README.md

+import numpy as np
+import time, sys
+
+from IPython.display import clear_output, display 


This is jupyter specific but won't work in standalone Python

Darktex · 2025-10-31T01:03:39Z

src/envs/wildfire_env/models.py

+    remaining_breaks: int = 0# optional shaping info
+
+@dataclass
+class WildfireState(State):


We should add burn_timers here. They currently get added dynamically upon reset which breaks type safety

Darktex · 2025-10-31T01:04:10Z

src/envs/wildfire_env/server/.ipynb_checkpoints/wildfire_environment-checkpoint.py

+        )
+
+        # per-cell burn timers (persist across steps)
+        self._state.burn_timers = [0] * (self.w * self.h)


See my comment in models.py

Add Wildfire Environment for OpenEnv (FastAPI, RL-compatible)

9f82c72

meta-cla bot added the CLA Signed This label is managed by the Meta Open Source bot. label Oct 28, 2025

shankerram3 added 2 commits October 28, 2025 10:21

Add sample rendering code to README

d888379

Updated README with sample rendering code for wildfree simulation.

Enhance README with wildfire simulation details

08b2a73

Added sections on wildfire simulation motivation, research goals, and citations to the README.

shankerram3 changed the title ~~New environment for the hackathon -Add Wildfire Environment for OpenEnv (FastAPI, RL-compatible)~~ [ENVIRONMENT] -Add Wildfire Environment for OpenEnv (FastAPI, RL-compatible) Oct 28, 2025

shankerram3 changed the title ~~[ENVIRONMENT] -Add Wildfire Environment for OpenEnv (FastAPI, RL-compatible)~~ [ENVIRONMENT] Wildfire Environment to simulate Wildfires for OpenEnv (FastAPI, RL-compatible) Oct 28, 2025

Darktex requested a review from Copilot October 31, 2025 00:30

Copilot AI reviewed Oct 31, 2025

View reviewed changes

Darktex requested changes Oct 31, 2025

View reviewed changes

	remaining_breaks: int = 0# optional shaping info
	remaining_breaks: int = 0

	meta = f"step={obs.step} wind={obs.wind_dir} hum={obs.humidity:.2f} burning={obs.burning_count} burned= {obs.burned_count}"
	meta = f"step={obs.step} wind={obs.wind_dir} hum={obs.humidity:.2f} burning={obs.burning_count} burned= {obs.burned_count}"

	return WildfireState(**payload)
	return WildfireState(**payload)

	## Sample rendering to see wildfree simulation
	## Sample rendering to see wildfire simulation

		from envs.wildfire_env.server.wildfire_environment import WildfireEnvironment


		client = WildfireEnv("http://localhost:8020")

		time.sleep(0.3)


		res = client.step(WildfireAction(action="WAIT"))

[ENVIRONMENT] Wildfire Environment to simulate Wildfires for OpenEnv (FastAPI, RL-compatible) #108

Are you sure you want to change the base?

[ENVIRONMENT] Wildfire Environment to simulate Wildfires for OpenEnv (FastAPI, RL-compatible) #108

Uh oh!

Conversation

shankerram3 commented Oct 28, 2025

Uh oh!

meta-cla bot commented Oct 28, 2025

Action Required

Process

Uh oh!

meta-cla bot commented Oct 28, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Key Changes

Reviewed Changes

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Darktex left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants