Upload folder using huggingface_hub

Dockerfile

@@ -4,17 +4,24 @@
 # This source code is licensed under the BSD-style license found in the
 # LICENSE file in the root directory of this source tree.
 
-# Use the specified openenv-base image
+# Use the standard openenv base image
+# Built from: docker build -t openenv-base:latest -f src/core/containers/images/Dockerfile .
+# In GitHub Actions, this is overridden to use the GHCR base image
+ARG BASE_IMAGE=ghcr.io/meta-pytorch/openenv-base:latest
 FROM ghcr.io/meta-pytorch/openenv-base:latest
 
 # Copy only what's needed for this environment
 COPY src/core/ /app/src/core/
-COPY src/envs/copy_env/ /app/src/envs/copy_env/
+COPY src/envs/echo_env/ /app/src/envs/echo_env/
+
+# Copy README for web interface documentation
+COPY src/envs/echo_env/README.md /app/README.md
 
 # Health check
 HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
     CMD curl -f http://localhost:8000/health || exit 1
 
 # Run the FastAPI server
-CMD ["uvicorn", "envs.copy_env.server.app:app", "--host", "0.0.0.0", "--port", "8000"]
 ENV ENABLE_WEB_INTERFACE=true
+
+CMD ["uvicorn", "envs.echo_env.server.app:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -1,37 +1,146 @@
 ---
-title: Copy_env Environment Server
-emoji: 🐳
-colorFrom: blue
-colorTo: green
+title: Echo Environment Server
+emoji: 🔊
+colorFrom: 'blue'
+colorTo: 'gray'
 sdk: docker
 pinned: false
 app_port: 8000
 base_path: /web
+tags:
+  - openenv
 ---
 
-# Copy_env Environment Server
+# Echo Environment
 
-FastAPI server for copy_env environment powered by Meta's OpenEnv.
+A simple test environment that echoes back messages. Perfect for testing the env APIs as well as demonstrating environment usage patterns.
 
-## About
+## Quick Start
 
-This Space provides a containerized environment for copy_env interactions.
-Built with FastAPI and OpenEnv framework.
+The simplest way to use the Echo environment is through the `EchoEnv` class:
 
-## Web Interface
+```python
+from envs.echo_env import EchoAction, EchoEnv
 
-This deployment includes an interactive web interface for exploring the environment:
-- **HumanAgent Interface**: Interact with the environment using a web form
-- **State Observer**: Real-time view of environment state and action history
-- **Live Updates**: WebSocket-based real-time updates
+try:
+    # Create environment from Docker image
+    echo_env = EchoEnv.from_docker_image("echo-env:latest")
 
-Access the web interface at: `/web`
+    # Reset
+    result = echo_env.reset()
+    print(f"Reset: {result.observation.echoed_message}")
 
+    # Send multiple messages
+    messages = ["Hello, World!", "Testing echo", "Final message"]
 
-## API Documentation
+    for msg in messages:
+        result = echo_env.step(EchoAction(message=msg))
+        print(f"Sent: '{msg}'")
+        print(f"  → Echoed: '{result.observation.echoed_message}'")
+        print(f"  → Length: {result.observation.message_length}")
+        print(f"  → Reward: {result.reward}")
 
-Visit `/docs` for interactive API documentation.
+finally:
+    # Always clean up
+    echo_env.close()
+```
 
-## Health Check
+That's it! The `EchoEnv.from_docker_image()` method handles:
+- Starting the Docker container
+- Waiting for the server to be ready
+- Connecting to the environment
+- Container cleanup when you call `close()`
 
-The environment provides a health check endpoint at `/health`.
+## Building the Docker Image
+
+Before using the environment, you need to build the Docker image:
+
+```bash
+# From project root
+docker build -t echo-env:latest -f src/envs/echo_env/server/Dockerfile .
+```
+
+## Environment Details
+
+### Action
+**EchoAction**: Contains a single field
+- `message` (str) - The message to echo back
+
+### Observation
+**EchoObservation**: Contains the echo response and metadata
+- `echoed_message` (str) - The message echoed back
+- `message_length` (int) - Length of the message
+- `reward` (float) - Reward based on message length (length × 0.1)
+- `done` (bool) - Always False for echo environment
+- `metadata` (dict) - Additional info like step count
+
+### Reward
+The reward is calculated as: `message_length × 0.1`
+- "Hi" → reward: 0.2
+- "Hello, World!" → reward: 1.3
+- Empty message → reward: 0.0
+
+## Advanced Usage
+
+### Connecting to an Existing Server
+
+If you already have an Echo environment server running, you can connect directly:
+
+```python
+from envs.echo_env import EchoEnv
+
+# Connect to existing server
+echo_env = EchoEnv(base_url="<ENV_HTTP_URL_HERE>")
+
+# Use as normal
+result = echo_env.reset()
+result = echo_env.step(EchoAction(message="Hello!"))
+```
+
+Note: When connecting to an existing server, `echo_env.close()` will NOT stop the server.
+
+## Development & Testing
+
+### Direct Environment Testing
+
+Test the environment logic directly without starting the HTTP server:
+
+```bash
+# From the server directory
+python3 src/envs/echo_env/server/test_echo_env.py
+```
+
+This verifies that:
+- Environment resets correctly
+- Step executes actions properly
+- State tracking works
+- Rewards are calculated correctly
+
+### Running the Full Example
+
+Run the complete example that demonstrates the full workflow:
+
+```bash
+python3 examples/local_echo_env.py
+```
+
+This example shows:
+- Creating an environment from a Docker image
+- Resetting and stepping through the environment
+- Automatic cleanup with `close()`
+
+## Project Structure
+
+```
+echo_env/
+├── __init__.py            # Module exports
+├── README.md              # This file
+├── client.py              # EchoEnv client implementation
+├── models.py              # Action and Observation models
+└── server/
+    ├── __init__.py        # Server module exports
+    ├── echo_environment.py  # Core environment logic
+    ├── app.py             # FastAPI application
+    ├── test_echo_env.py   # Direct environment tests
+    └── Dockerfile         # Container image definition
+```

src/core/pyproject.toml

@@ -18,8 +18,14 @@ dependencies = [
     "requests>=2.25.0",
     "fastapi>=0.104.0",
     "uvicorn>=0.24.0",
+    "huggingface_hub>=0.20.0",
+    "rich>=13.0.0",
+    "typer>=0.12.0",
 ]
 
+[project.scripts]
+openenv = "openenv_cli.__main__:main"
+
 [project.optional-dependencies]
 dev = [
     "pytest>=7.0.0",
@@ -41,6 +47,10 @@ packages = [
     "openenv_core.containers",
     "openenv_core.containers.runtime",
     "openenv_core.env_server",
-    "openenv_core.tools"
+    "openenv_core.tools",
+    "openenv_cli",
+    "openenv_cli.commands",
+    "openenv_cli.core",
+    "openenv_cli.utils",
 ]
-package-dir = {"openenv_core" = "."}
+package-dir = {"openenv_core" = ".", "openenv_cli" = "../openenv_cli"}

src/envs/copy_env/README.md

@@ -1,8 +1,8 @@
 ---
 title: Echo Environment Server
 emoji: 🔊
-colorFrom: '#00C9FF'
-colorTo: '#1B2845'
+colorFrom: 'blue'
+colorTo: 'gray'
 sdk: docker
 pinned: false
 app_port: 8000