Ignore local WolfeClick space clone

.gitignore

@@ -19,3 +19,4 @@ env/
 # IDE / OS
 .idea/
 .DS_Store
+WolfeClick

Dockerfile

@@ -0,0 +1,34 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies: git, curl for healthcheck, and Node.js for Pokemon Showdown
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    curl \
+    nodejs \
+    npm \
+  && rm -rf /var/lib/apt/lists/*
+
+# Clone Pokemon Showdown so poke-env can connect to a local server
+RUN git clone https://github.com/smogon/pokemon-showdown.git /opt/pokemon-showdown
+
+# Copy the entire repo into the image (includes smogon_rl and env server)
+COPY . /app
+
+# Install Python dependencies, including OpenEnv core 0.2.1
+RUN pip install --no-cache-dir \
+    \"openenv-core==0.2.1\" \
+    \"poke-env>=0.8.0,<0.9.0\" \
+    \"numpy>=1.24.0\" \
+    \"pydantic>=2.0.0\"
+
+ENV SHOWDOWN_DIR=/opt/pokemon-showdown
+
+# Basic healthcheck against the FastAPI app port
+HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
+  CMD curl -f http://localhost:8001/health || exit 1
+
+# Start Pokemon Showdown on port 8000 (for poke-env) and the OpenEnv FastAPI app on port 8001
+CMD bash -lc \"cd /opt/pokemon-showdown && node pokemon-showdown start --no-security --port 8000 & uvicorn env.server.app:app --host 0.0.0.0 --port 8001\"
+

README.md

@@ -1,3 +1,16 @@
+---
+title: OpenEnv-WolfeClick Environment
+emoji: 🎮
+colorFrom: blue
+colorTo: purple
+sdk: docker
+app_port: 8001
+tags:
+ - openenv
+ - pokemon
+ - rl
+---
+
 # OpenEnv-WolfeClick
 
 OpenEnv-WolfeClick is a reinforcement learning environment and training workflow for competitive Pokemon battles with large language models.

__init__.py

@@ -0,0 +1,7 @@
+"""
+Package marker for the OpenEnv-WolfeClick environment repository.
+
+This file exists so the project root can be treated as a valid
+OpenEnv environment package when using `openenv push`.
+"""
+

client.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from typing import Any, Dict
+
+from openenv.core import EnvClient
+from openenv.core.client_types import StepResult
+
+from env.models import WolfeClickAction, WolfeClickObservation, WolfeClickState
+
+
+class WolfeClickEnv(EnvClient[WolfeClickAction, WolfeClickObservation, WolfeClickState]):
+    """HTTP/WebSocket client for the WolfeClick OpenEnv environment."""
+
+    def _step_payload(self, action: WolfeClickAction) -> Dict[str, Any]:
+        # Matches the action schema expected by WolfeClickEnvironment.step.
+        return {"action_json": action.action_json}
+
+    def _parse_result(self, payload: Dict[str, Any]) -> StepResult[WolfeClickObservation]:
+        obs_payload = payload.get("observation", {})
+        obs = WolfeClickObservation(
+            state_markdown=obs_payload.get("state_markdown", ""),
+            done=bool(obs_payload.get("done", payload.get("done", False))),
+            reward=float(payload.get("reward", 0.0)),
+            metadata=obs_payload.get("metadata") or {},
+        )
+        return StepResult(
+            observation=obs,
+            reward=payload.get("reward"),
+            done=payload.get("done", obs.done),
+        )
+
+    def _parse_state(self, payload: Dict[str, Any]) -> WolfeClickState:
+        # Base State already defines episode_id and step_count; we pass through the payload.
+        return WolfeClickState(**payload)
+
+
+__all__ = ["WolfeClickEnv"]
+

models.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+"""
+Top-level models shim for the WolfeClick OpenEnv environment.
+
+Exposes the same types as `env.models` so tools expecting a standard
+OpenEnv layout (client.py, models.py, server/app.py) can import them.
+"""
+
+from env.models import WolfeClickAction, WolfeClickObservation, WolfeClickState
+
+__all__ = ["WolfeClickAction", "WolfeClickObservation", "WolfeClickState"]
+

openenv.yaml

@@ -0,0 +1,7 @@
+spec_version: 1
+name: openenv-wolfeclick
+type: space
+runtime: fastapi
+app: env.server.app:app
+port: 8001
+

pyproject.toml

@@ -11,8 +11,12 @@ dependencies = [
   "poke-env>=0.8.0,<0.9.0",
   "numpy>=1.24.0",
   "pydantic>=2.0.0",
+  "openenv-core>=0.2.1",
 ]
 
+[project.scripts]
+server = "env.server.app:main"
+
 [project.optional-dependencies]
 dev = [
   "pytest>=7.0.0",
@@ -24,7 +28,4 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.uv]
-package = "smogon-rl"
-
-[tool.uv.sources]
-
+package = true

server/Dockerfile

@@ -0,0 +1,34 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies: git, curl for healthcheck, and Node.js for Pokemon Showdown
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    curl \
+    nodejs \
+    npm \
+  && rm -rf /var/lib/apt/lists/*
+
+# Clone Pokemon Showdown so poke-env can connect to a local server
+RUN git clone https://github.com/smogon/pokemon-showdown.git /opt/pokemon-showdown
+
+# Copy the entire repo into the image (includes smogon_rl and env server)
+COPY . /app
+
+# Install Python dependencies, including OpenEnv core 0.2.1
+RUN pip install --no-cache-dir \
+    "openenv-core==0.2.1" \
+    "poke-env>=0.8.0,<0.9.0" \
+    "numpy>=1.24.0" \
+    "pydantic>=2.0.0"
+
+ENV SHOWDOWN_DIR=/opt/pokemon-showdown
+
+# Basic healthcheck against the FastAPI app port
+HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
+  CMD curl -f http://localhost:8001/health || exit 1
+
+# Start Pokemon Showdown on port 8000 (for poke-env) and the OpenEnv FastAPI app on port 8001
+CMD bash -lc "cd /opt/pokemon-showdown && node pokemon-showdown start --no-security --port 8000 & uvicorn env.server.app:app --host 0.0.0.0 --port 8001"
+

server/__init__.py

@@ -0,0 +1,2 @@
+"""Server package for the WolfeClick OpenEnv environment."""
+

server/app.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+"""
+Thin wrapper so `openenv` and `uv run server` can find the ASGI app.
+"""
+
+from env.server.app import app as _inner_app
+from env.server.app import main as _inner_main
+
+app = _inner_app
+
+
+def main() -> None:
+    _inner_main()
+
+
+__all__ = ["app", "main"]
+
+
+if __name__ == "__main__":
+    main()
+
+