langgraph/cloud/deployment/custom_docker/

[giscus[bot]]

langgraph/cloud/deployment/custom_docker/

Build language agents as graphs

https://langchain-ai.github.io/langgraph/cloud/deployment/custom_docker/

[bossjones]

In case anyone is looking for an attempt to get uv working on langgraph (apologies for all the comments, it's a work in progress):

{
    "dockerfile_lines": [
        "# Install system dependencies",

        "ENV UV_SYSTEM_PYTHON=1 \\",
        "    UV_PIP_DEFAULT_PYTHON=/usr/bin/python3 \\",
        "    UV_LINK_MODE=copy \\",
        "    UV_CACHE_DIR=/root/.cache/uv/ \\",
        "    PYTHONASYNCIODEBUG=1 \\",
        "    DEBIAN_FRONTEND=noninteractive \\",
        "    TAPLO_VERSION=0.9.3 \\",
        "   PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \\",
        "    PYTHONFAULTHANDLER=1",
        "",
        "RUN apt-get update && apt-get install -y --no-install-recommends python3-dev python3 ca-certificates python3-numpy python3-setuptools python3-wheel python3-pip g++ gcc ninja-build cmake build-essential autoconf automake libtool libmagic-dev poppler-utils libreoffice libomp-dev tesseract-ocr tesseract-ocr-por libyaml-dev ffmpeg libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python3-openssl git libpq5 libpq-dev libxml2-dev libxslt1-dev libcairo2-dev libgirepository1.0-dev libgraphviz-dev libjpeg-dev libopencv-dev libpango1.0-dev libprotobuf-dev protobuf-compiler rustc cargo libwebp-dev libzbar0 libzbar-dev imagemagick ghostscript pandoc aria2 zsh bash-completion libpq-dev pkg-config libssl-dev  openssl unzip gzip vim tree less sqlite3 && rm -rf /var/lib/apt/lists/*",

        "# ENV PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",

        "# Install justfile",

        "RUN curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -x -s -- --to /usr/bin",

        "# debugging, show the current directory and the contents of the deps directory, look for .venv which should not exist.",
        "RUN ls -lta && echo `pwd` && ls -lta && tree && echo \"PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'\" >> ~/.bashrc && echo \"PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'\" >> ~/.profile",

        "# Hopefully this will fix the path issue with langgraph studio grabbing the env vars from my host machine.",

        "# ENV TAPLO_VERSION=0.9.3",
        "COPY ./install_taplo.sh .",
        "RUN chmod +x install_taplo.sh && bash -x ./install_taplo.sh && mv taplo /usr/local/bin/taplo && rm install_taplo.sh",


        "# Install rust",

        "RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | env PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' bash -x -s -- -y",
        "ENV PATH='/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'",


        "# Install UV 0.5.14",

        "ADD https://astral.sh/uv/0.5.14/install.sh /uv-installer.sh",
        "RUN env PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' bash -x /uv-installer.sh && rm /uv-installer.sh",
        "ENV PATH='/root/.local/bin:/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'",

        "# Configure UV",

        "# UV_SYSTEM_PYTHON: Equivalent to the --system command-line argument. If set to true, uv will use the first Python interpreter found in the system PATH. WARNING: UV_SYSTEM_PYTHON=true is intended for use in continuous integration (CI) or containerized environments and should be used with caution, as modifying the system Python can lead to unexpected behavior.",



        "# ENV UV_SYSTEM_PYTHON=1",
        "# ENV UV_PIP_DEFAULT_PYTHON=/usr/bin/python3",
        "# ENV UV_LINK_MODE=copy",

        "# Compiling Python source files to bytecode is typically desirable for production images as it tends to improve startup time (at the cost of increased installation time).",
        "# ENV UV_COMPILE_BYTECODE=1",
        "# ENV UV_CACHE_DIR=/root/.cache/uv/",

        "# Install dependencies first (for better caching)",


        "WORKDIR /deps/democracy-exe",

        "COPY pyproject.toml uv.lock ./",

        "RUN --mount=type=cache,target=/root/.cache/uv --mount=type=bind,source=uv.lock,target=uv.lock --mount=type=bind,source=pyproject.toml,target=pyproject.toml --mount=type=bind,source=democracy_exe/requirements.txt,target=requirements.txt uv sync --frozen --no-install-project --verbose --no-dev && PYTHONDONTWRITEBYTECODE=1 uv pip install --no-cache-dir --system -r requirements.txt -e /deps/* --verbose",


        "# Copy project and install",

        "COPY . /deps/democracy-exe",
        "RUN --mount=type=cache,target=/root/.cache/uv uv sync --verbose --no-dev --frozen",
        "# RUN uv tool dir --bin && ls -lta && pwd && ls -lta /deps && tree /deps && cat ~/.bashrc && env && cat ~/.cargo/env && cat ~/.profile && echo \"alias pip='uv pip'\" >> ~/.bashrc && echo \"alias pip='uv pip'\" >> ~/.profile",


        "# Pre-compile bytecode",
        "# RUN python3 -m compileall .",
        "# RUN ls -lta && pwd && ls -lta /deps && tree /deps && cat ~/.bashrc && env && cat ~/.cargo/env && cat ~/.profile && echo \"alias pip='uv pip'\" >> ~/.bashrc && echo \"alias pip='uv pip'\" >> ~/.profile",

        "# Use the virtual environment automatically",
        "# ENV VIRTUAL_ENV=\"/deps/democracy-exe/.venv\"",


        "# uv: Once the project is installed, you can either activate the project virtual environment by placing its binary directory at the front of the path:",
        "# Place entry points in the environment at the front of the path",
        "# Disabling the virtual environment for now.",
        "# ENV PATH='/deps/democracy-exe/.venv/bin:/root/.local/bin:/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'",


        "# Add the project directory to the Python path. Source: https://github.com/bradcstevens/mtg-judgebot/blob/35ab51f7cd7341801f9364e93871a58464c93e7b/langgraph.json",
        "# ENV PYTHONPATH='/deps/democracy-exe'",


        "# ENV PYTHONPATH='/deps/democracy-exe:$PYTHONPATH'",
        "# hardcoded path cause langgraph is rendering the env vars from my host machine.",
        "# ENV PATH=\"/deps/democracy-exe/.venv/bin:/root/.local/bin:/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/sbin:/usr/bin:/sbin:/bin\"",
        "#RUN cat ~/.bashrc && env && cat ~/.cargo/env && cat ~/.profile",

        "# EXPERIMENTAL: alias pip='uv pip' to use uv pip instead of pip",
        "# RUN echo \"alias pip='uv pip'\" >> ~/.bashrc",
        "# RUN echo \"alias pip='uv pip'\" >> ~/.profile",

        "# Seems as though things only work when we don't use the virtual environment and add it to our path.",

        "# Enable asyncio debugging",
        "# ENV PYTHONASYNCIODEBUG=1",

        "# Enable fault handler",
        "# ENV PYTHONFAULTHANDLER=1"
    ],
    "graphs": {
        "react": "./democracy_exe/agentic/workflows/react/graph.py:graph"

    },
    "env": ".env",
    "python_version": "3.12",
    "dependencies": [
        "."
    ],
    "env_vars": {
        "PYTHONDONTWRITEBYTECODE": "1",
        "PYTHONUNBUFFERED": "1",
        "UV_CACHE_DIR": "/root/.cache/uv/",
        "UV_COMPILE_BYTECODE": "1",
        "UV_LINK_MODE": "copy",
        "UV_PIP_DEFAULT_PYTHON": "/usr/bin/python3",
        "UV_SYSTEM_PYTHON": "1",
        "TAPLO_VERSION": "0.9.3",
        "PYTHONPATH": "${PYTHONPATH}:${PWD}"
    }
}

when you run: langgraph dockerfile -c langgraph.json Dockerfile you get this:

FROM langchain/langgraph-api:3.12

# Install system dependencies
ENV UV_SYSTEM_PYTHON=1 \
    UV_PIP_DEFAULT_PYTHON=/usr/bin/python3 \
    UV_LINK_MODE=copy \
    UV_CACHE_DIR=/root/.cache/uv/ \
    PYTHONASYNCIODEBUG=1 \
    DEBIAN_FRONTEND=noninteractive \
    TAPLO_VERSION=0.9.3 \
   PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \
    PYTHONFAULTHANDLER=1

RUN apt-get update && apt-get install -y --no-install-recommends python3-dev python3 ca-certificates python3-numpy python3-setuptools python3-wheel python3-pip g++ gcc ninja-build cmake build-essential autoconf automake libtool libmagic-dev poppler-utils libreoffice libomp-dev tesseract-ocr tesseract-ocr-por libyaml-dev ffmpeg libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python3-openssl git libpq5 libpq-dev libxml2-dev libxslt1-dev libcairo2-dev libgirepository1.0-dev libgraphviz-dev libjpeg-dev libopencv-dev libpango1.0-dev libprotobuf-dev protobuf-compiler rustc cargo libwebp-dev libzbar0 libzbar-dev imagemagick ghostscript pandoc aria2 zsh bash-completion libpq-dev pkg-config libssl-dev  openssl unzip gzip vim tree less sqlite3 && rm -rf /var/lib/apt/lists/*
# ENV PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# Install justfile
RUN curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -x -s -- --to /usr/bin
# debugging, show the current directory and the contents of the deps directory, look for .venv which should not exist.
RUN ls -lta && echo `pwd` && ls -lta && tree && echo "PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'" >> ~/.bashrc && echo "PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'" >> ~/.profile
# Hopefully this will fix the path issue with langgraph studio grabbing the env vars from my host machine.
# ENV TAPLO_VERSION=0.9.3
COPY ./install_taplo.sh .
RUN chmod +x install_taplo.sh && bash -x ./install_taplo.sh && mv taplo /usr/local/bin/taplo && rm install_taplo.sh
# Install rust
RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | env PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' bash -x -s -- -y
ENV PATH='/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'
# Install UV 0.5.14
ADD https://astral.sh/uv/0.5.14/install.sh /uv-installer.sh
RUN env PATH='/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' bash -x /uv-installer.sh && rm /uv-installer.sh
ENV PATH='/root/.local/bin:/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'
# Configure UV
# UV_SYSTEM_PYTHON: Equivalent to the --system command-line argument. If set to true, uv will use the first Python interpreter found in the system PATH. WARNING: UV_SYSTEM_PYTHON=true is intended for use in continuous integration (CI) or containerized environments and should be used with caution, as modifying the system Python can lead to unexpected behavior.
# ENV UV_SYSTEM_PYTHON=1
# ENV UV_PIP_DEFAULT_PYTHON=/usr/bin/python3
# ENV UV_LINK_MODE=copy
# Compiling Python source files to bytecode is typically desirable for production images as it tends to improve startup time (at the cost of increased installation time).
# ENV UV_COMPILE_BYTECODE=1
# ENV UV_CACHE_DIR=/root/.cache/uv/
# Install dependencies first (for better caching)
WORKDIR /deps/democracy-exe
COPY pyproject.toml uv.lock ./
RUN --mount=type=cache,target=/root/.cache/uv --mount=type=bind,source=uv.lock,target=uv.lock --mount=type=bind,source=pyproject.toml,target=pyproject.toml --mount=type=bind,source=democracy_exe/requirements.txt,target=requirements.txt uv sync --frozen --no-install-project --verbose --no-dev && PYTHONDONTWRITEBYTECODE=1 uv pip install --no-cache-dir --system -r requirements.txt -e /deps/* --verbose
# Copy project and install
COPY . /deps/democracy-exe
RUN --mount=type=cache,target=/root/.cache/uv uv sync --verbose --no-dev --frozen
# RUN uv tool dir --bin && ls -lta && pwd && ls -lta /deps && tree /deps && cat ~/.bashrc && env && cat ~/.cargo/env && cat ~/.profile && echo "alias pip='uv pip'" >> ~/.bashrc && echo "alias pip='uv pip'" >> ~/.profile
# Pre-compile bytecode
# RUN python3 -m compileall .
# RUN ls -lta && pwd && ls -lta /deps && tree /deps && cat ~/.bashrc && env && cat ~/.cargo/env && cat ~/.profile && echo "alias pip='uv pip'" >> ~/.bashrc && echo "alias pip='uv pip'" >> ~/.profile
# Use the virtual environment automatically
# ENV VIRTUAL_ENV="/deps/democracy-exe/.venv"
# uv: Once the project is installed, you can either activate the project virtual environment by placing its binary directory at the front of the path:
# Place entry points in the environment at the front of the path
# Disabling the virtual environment for now.
# ENV PATH='/deps/democracy-exe/.venv/bin:/root/.local/bin:/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin'
# Add the project directory to the Python path. Source: https://github.com/bradcstevens/mtg-judgebot/blob/35ab51f7cd7341801f9364e93871a58464c93e7b/langgraph.json
# ENV PYTHONPATH='/deps/democracy-exe'
# ENV PYTHONPATH='/deps/democracy-exe:$PYTHONPATH'
# hardcoded path cause langgraph is rendering the env vars from my host machine.
# ENV PATH="/deps/democracy-exe/.venv/bin:/root/.local/bin:/root/.cargo/bin:/usr/local/bin:/usr/local/sbin:/usr/sbin:/usr/bin:/sbin:/bin"
#RUN cat ~/.bashrc && env && cat ~/.cargo/env && cat ~/.profile
# EXPERIMENTAL: alias pip='uv pip' to use uv pip instead of pip
# RUN echo "alias pip='uv pip'" >> ~/.bashrc
# RUN echo "alias pip='uv pip'" >> ~/.profile
# Seems as though things only work when we don't use the virtual environment and add it to our path.
# Enable asyncio debugging
# ENV PYTHONASYNCIODEBUG=1
# Enable fault handler
# ENV PYTHONFAULTHANDLER=1

ADD . /deps/democracy-exe

RUN PYTHONDONTWRITEBYTECODE=1 pip install --no-cache-dir -c /api/constraints.txt -e /deps/*

ENV LANGSERVE_GRAPHS='{"react": "/deps/democracy-exe/democracy_exe/agentic/workflows/react/graph.py:graph"}'

WORKDIR /deps/democracy-exe