ARM64 compatibility issue with langgraph-api:3.11 Docker image

[nikkidurkin]

On December 7th, 2024, the langgraph-api:3.11 image was updated with ARM64 support (manifest shows arm64 platform). However, when running on Apple Silicon (M1/M2) Macs, the entrypoint script fails with:

exec /storage/entrypoint.sh: exec format error

System Details:

• MacOS on Apple Silicon (ARM64)
• Docker Desktop 4.36.0
• Docker Engine 27.3.1

The image metadata shows:

• Created: 2024-12-07T00:40:21
• New environment variable: LANGSMITH_LANGGRAPH_API_VARIANT=licensed
• Architecture: arm64

While the image is marked as arm64-compatible, the entrypoint.sh script appears to not be properly compiled for ARM64 architecture.

Current Workaround:
I made it work by forcing AMD64 platform and using QEMU emulation:

{
  "dockerfile_lines": [
    "FROM --platform=linux/amd64 langchain/langgraph-api:3.11",
    "RUN apt-get update && apt-get install -y qemu-user-static"
  ]
}

Before the December 7 update, studio was working perfectly fine on my machine. But now, this workaround requires QEMU emulation which is very CPU-intensive on ARM64 machines.

This happened as I was working through your langchain-academy course, which is set up with python 3.11. So other beginners are probably having the same issue as me... one minute it's working fine, the next minute studio won't load the project.

I moved onto a different tutorial from copilotkit.ai which uses python 3.12, and that seems to be working fine when I load the project into studio.