langchain-superserve

Superserve sandbox integration for Deep Agents. Because Deep Agents compiles to a LangGraph graph, this works across LangChain, LangGraph, and DeepAgents.

Quick Install

pip install langchain-superserve

Deep Agents SDK

from superserve import Sandbox
from langchain_superserve import SuperserveSandbox

# Launch from a python-equipped template so the agent's file tools work (see below).
sandbox = Sandbox.create(name="my-agent", from_template="superserve/python-3.11")
backend = SuperserveSandbox(sandbox=sandbox)

try:
    result = backend.execute("echo hello")
    print(result.output)
finally:
    sandbox.kill()

Pass the connected SuperserveSandbox as the backend to create_deep_agent(...) to run the agent's shell and file operations inside a Superserve microVM.

Deep Agents Code

Installing this package registers a superserve sandbox provider for the deepagents-code (dcode) terminal agent:

dcode --install langchain-superserve --package
export SUPERSERVE_API_KEY=ss_live_...
dcode --sandbox superserve

The provider defaults to the superserve/python-3.11 template; override with SUPERSERVE_TEMPLATE.

Requirements

SuperserveSandbox adapts a Superserve sandbox to the Deep Agents sandbox protocol. The protocol synthesizes ls/read/edit/glob (and the write preflight) with in-sandbox python3, so launch from a python-equipped image — superserve/python-3.11, superserve/python-ml, or superserve/code-interpreter. execute, grep, and file upload/download work on any image, including the minimal superserve/base.

Superserve extras

Beyond the standard backend, Superserve sandboxes offer pause()/resume() for idle cost savings and proxy-brokered secret binding (Sandbox.create(secrets=...)) so real credentials never enter the sandbox. Manage these through the Superserve SDK on the sandbox you pass in.

Development

uv sync --group test
make test                                       # unit tests (no network)
make lint                                        # ruff + ty
SUPERSERVE_API_KEY=ss_live_... make integration_tests   # standard suite, live

Integration tests create a real sandbox from superserve/python-3.11 (override with SUPERSERVE_TEMPLATE) and skip cleanly when SUPERSERVE_API_KEY is unset.