Skip to main content
MeshAgent publishes base images so you can package and ship agents/services quickly without building every dependency from scratch. Where to pull For faster cold starts, every image has a stargz-optimized variant with an -esgz tag (e.g., meshagent/python:<tag>-esgz, meshagent/cli:{version}-esgz, or meshagent/cli-playwright:{version}-esgz). If you are building your own container we recommend creating a stargz-optimized image, this will make it much faster to pull and run your image. Image catalog Quick rule:
  • meshagent/python and meshagent/node are the slimmer language runtime base images.
  • meshagent/python-sdk, meshagent/python-sdk-slim, and meshagent/node-sdk are the SDK images with MeshAgent-specific packages or workspace scaffolding already included.
  • meshagent/cli is the lean CLI runtime image. Use meshagent/cli-playwright when the container needs bundled Playwright browsers and browser runtime libraries.
ImageBest forWhat’s insideNotes
meshagent/cliRunning or modifying process-backed CLI agents or VoiceBot when you do not need in-container browser automation. Great starting point to set custom rules and add tools to an agent without writing custom code.Prebuilt meshagent binary with all CLI flags in a lean runtime imageTypically use meshagent process join ... for text agents or meshagent voicebot join ... for voice agents when the agent connects directly with MESHAGENT_TOKEN. Use the ... service form only when you want the process to expose an HTTP endpoint and wire it through ports:.
meshagent/cli-playwrightCLI agents that need bundled Playwright/Stagehand browser automation inside the containermeshagent/cli plus Playwright browser assets, Xvfb, fonts, and browser runtime librariesUse this when the agent itself launches Chromium or other Playwright-managed browsers in the container. If you do not need browser automation, prefer meshagent/cli for smaller pulls and faster cold starts.
meshagent/pythonMinimal Python runtime base for custom images and runtime-label deploy flowsPython 3.13 slim runtime baseUse this when you want the base language runtime and will install your own app dependencies or let MeshAgent layer code on top at deploy time. This is not the same image as meshagent/python-sdk.
meshagent/python-sdk-slimSmaller Python SDK image for standard Python agents/services that do not need voice dependenciesmeshagent/python plus MeshAgent API/Agents/Tools/OpenAI + OTEL; uv preinstalledRecommended starting point when you want MeshAgent Python packages preinstalled but do not need LiveKit/audio extras.
meshagent/python-sdkFull Python SDK image for Python services that want MeshAgent dependencies preinstalledpython-sdk-slim plus LiveKit/audio, MCP, Computers, MarkItDown, etc.Use this when you want a batteries-included Python SDK image. If you only need a Python runtime base, use meshagent/python instead.
meshagent/shellShell-based tools/agents that need common Linux utilitiesPython 3.13 slim + MeshAgent SDK + common CLI tools (curl, git, ripgrep, etc.)Handy for “developer” style agents or shell-based utilities.
meshagent/nodeMinimal Node runtime base for custom JS/TS service imagesNode runtime base imageUse this when you want plain Node as your base and will install or copy your own application code yourself. This is not the same image as meshagent/node-sdk.
meshagent/node-sdkNode SDK/workspace image for JS/TS services using the MeshAgent SDK scaffoldNode runtime plus the MeshAgent TS SDK workspace scaffold (meshagent-entrypoint and meshagent-ts)Preferred SDK image when you want the MeshAgent TS workspace already present. Also published with the compatibility tag meshagent/nodejs-sdk.
meshagent/dotnet-sdk.NET servicesLatest .NET SDK + MeshAgent .NET SDK sourceUse dotnet publish in your Dockerfile stage.
meshagent/flutterFlutter UI buildsFlutter SDK + MeshAgent Flutter/Dart workspacesFor building/publishing Flutter-based UIs.
Tagging & architectures
  • Tags: latest, versioned tags (e.g., 0.8.x), and stargz variants (*-esgz). If you want lazy-pull startup speed, pick the -esgz tag; it falls back gracefully if the runtime doesn’t support stargz.
  • Platform: images are published for linux/amd64.
  • Using Containers: Learn how to run containers through the MeshAgent Containers API. This is very helpful for running code on demand inside a Room.
  • Optimizing Containers: Learn how to optimize your container when deploying a custom service.