Dockerfile

# Copyright (c) Meta Platforms, Inc. and affiliates.
# All rights reserved.
#
# This source code is licensed under the BSD-style license found in the
# LICENSE file in the root directory of this source tree.

# Multi-stage build for Pokemon Red OpenEnv
# Builds a containerized PyBoy emulator environment for RL training
#
# Build: openenv build
# Run:   docker run -p 8000:8000 pokemonred-env:latest
#
# Environment variables:
#   POKEMON_HEADLESS: Run without display (default: true)
#   POKEMON_ACTION_FREQ: Emulator ticks per action (default: 24)
#   POKEMON_ROM_PATH: Path to ROM file (default: /app/env/server/PokemonRed.gb)
#   POKEMON_INIT_STATE: Path to save state (default: /app/env/server/init.state)

ARG BASE_IMAGE=ghcr.io/meta-pytorch/openenv-base:latest
FROM ${BASE_IMAGE} AS builder

WORKDIR /app

# Install build dependencies for PyBoy and SDL2
RUN apt-get update && apt-get install -y --no-install-recommends \
    git \
    build-essential \
    libsdl2-dev \
    libsdl2-image-dev \
    libsdl2-mixer-dev \
    libsdl2-ttf-dev \
    python3-dev \
    && rm -rf /var/lib/apt/lists/*

# Build arguments
ARG BUILD_MODE=in-repo
ARG ENV_NAME=pokemonred_env

# Copy environment code
COPY . /app/env

WORKDIR /app/env

# Ensure uv is available
RUN if ! command -v uv >/dev/null 2>&1; then \
    curl -LsSf https://astral.sh/uv/install.sh | sh && \
    mv /root/.local/bin/uv /usr/local/bin/uv && \
    mv /root/.local/bin/uvx /usr/local/bin/uvx; \
    fi

# Install dependencies using uv sync
RUN --mount=type=cache,target=/root/.cache/uv \
    if [ -f uv.lock ]; then \
    uv sync --frozen --no-install-project --no-editable; \
    else \
    uv sync --no-install-project --no-editable; \
    fi

RUN --mount=type=cache,target=/root/.cache/uv \
    if [ -f uv.lock ]; then \
    uv sync --frozen --no-editable; \
    else \
    uv sync --no-editable; \
    fi

# Final runtime stage
FROM ${BASE_IMAGE}

WORKDIR /app

# Install runtime dependencies for PyBoy headless operation
RUN apt-get update && apt-get install -y --no-install-recommends \
    libsdl2-2.0-0 \
    libsdl2-image-2.0-0 \
    curl \
    && rm -rf /var/lib/apt/lists/*

# Copy the virtual environment from builder
COPY --from=builder /app/env/.venv /app/.venv

# Copy the environment code
COPY --from=builder /app/env /app/env

# Set PATH to use the virtual environment
ENV PATH="/app/.venv/bin:$PATH"

# Set PYTHONPATH for imports
ENV PYTHONPATH="/app/env:$PYTHONPATH"

# Configure SDL for headless operation (no display, no audio)
ENV SDL_VIDEODRIVER=dummy
ENV SDL_AUDIODRIVER=dummy

# Default environment configuration
ENV POKEMON_HEADLESS=true
ENV POKEMON_ACTION_FREQ=24
ENV POKEMON_ROM_PATH=/app/env/server/PokemonRed.gb
ENV POKEMON_INIT_STATE=/app/env/server/init.state
ENV POKEMON_MAX_STEPS=163840
ENV POKEMON_SESSION_PATH=/tmp/pokemon_sessions

# Create session directory
RUN mkdir -p /tmp/pokemon_sessions

# Health check
HEALTHCHECK --interval=30s --timeout=10s --start-period=30s --retries=3 \
    CMD curl -f http://localhost:8000/health || exit 1

# Expose port
EXPOSE 8000

# Run the FastAPI server
ENV ENABLE_WEB_INTERFACE=true
CMD ["sh", "-c", "cd /app/env && uvicorn server.app:app --host 0.0.0.0 --port 8000"]