Dockerfile

# 🔱 Imperial Shadow Brain (API Core) - Hugging Face Spaces Dockerfile
# [v3.0.0] — Playwright MCP Full Support (Node.js + Chromium)
FROM python:3.10-slim

# 1. Install System Dependencies (Playwright OS Dependencies + Node.js)
# Playwright requires specific system libraries to run chromium in headless mode.
# Node.js is required for npx @playwright/mcp --headless (MCP stdio server).
RUN apt-get update && apt-get install -y --no-install-recommends \
    libpq-dev \
    gcc \
    curl \
    gnupg \
    # Chromium runtime dependencies
    libglib2.0-0 \
    libnss3 \
    libnspr4 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxrandr2 \
    libgbm1 \
    libasound2 \
    libpango-1.0-0 \
    libcairo2 \
    # 🔱 [HF Headless Fix] 가상 디스플레이(Xvfb) — google-surf-mcp 등 headed 브라우저가
    # HF 컨테이너(X server 없음)에서 동작하도록 한다. xauth 는 xvfb-run 에 필요.
    xvfb \
    xauth \
    && rm -rf /var/lib/apt/lists/*

# 2. Install Node.js 20 LTS (required for npx @playwright/mcp)
RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
    && apt-get install -y --no-install-recommends nodejs \
    && rm -rf /var/lib/apt/lists/*

# 3. Pre-install MCP servers globally so npx doesn't need to download at runtime
RUN npm install -g @playwright/mcp google-surf-mcp

# 3b. [HF Headless Fix] X11 유닉스 소켓 디렉터리를 미리 생성(sticky). 비root(user 1000)로 실행되는
# 컨테이너에서 xvfb-run 이 X 서버 소켓을 만들 수 있어야 한다. 없으면 "Missing X server" 가 계속 난다.
RUN mkdir -p /tmp/.X11-unix && chmod 1777 /tmp/.X11-unix

# 4. Set Environment Variables
ENV PYTHONUNBUFFERED=1
ENV PORT=7860
ENV APP_ENV=live

# 5. Create non-root user for HF Spaces (Best Practice)
RUN useradd -m -u 1000 user
USER user
ENV HOME=/home/user \
    PATH=/home/user/.local/bin:$PATH

WORKDIR $HOME/app

# 6. Copy and Install Python Dependencies
COPY --chown=user requirements.txt .
RUN pip install --no-cache-dir --upgrade pip && \
    pip install --no-cache-dir --user -r requirements.txt && \
    python -m playwright install chromium

# 7. Copy Application Source Code
COPY --chown=user . .

# 8. Expose the required port for HF Spaces
EXPOSE 7860

# 9. Start the Imperial Core
# Use shell form to resolve environment variable $PORT provided by HF Spaces.
# 🔱 [HF Headless Fix] xvfb-run 으로 가상 디스플레이 위에서 실행 → gunicorn이 띄우는
# MCP 브라우저 자식 프로세스(google-surf 등)가 DISPLAY 를 상속받아 정상 구동된다.
CMD xvfb-run --auto-servernum --server-args="-screen 0 1280x1024x24 -nolisten tcp" gunicorn --bind 0.0.0.0:${PORT:-7860} --workers 1 --threads 4 --timeout 120 --access-logfile - --error-logfile - app:app