This release is a pre-release and may not be stable for production use.
Python authoring package and CLI launcher for Managed Deep Agents.
[!IMPORTANT] Active development / private beta. Managed Deep Agents is in active development and currently in private beta. The PyPI package API and managed runtime contract may change. Join the waitlist for access and updates.
managed-deepagents is the PyPI package for authoring Managed Deep Agents in
Python. It includes:
define_deep_agent, the Python authoring contract for managed agents.define_schedule, the Python contract for managed cron schedules.mda, the CLI used to build and deploy your agent to LangSmith.managed_deepagents.runtime, the runtime helper used by generated managed entry modules.
Install
uv tool install managed-deepagents
[!NOTE] Private beta: dev releases only. We currently publish only PEP 440 pre-release (dev) versions and no stable version yet. uv skips pre-releases by default unless they are allowed explicitly:
uv tool install --prerelease allow managed-deepagents
This package requires Python 3.9 or newer. Each platform wheel bundles the
prebuilt mda binary for its OS and CPU architecture and exposes it through the
mda console script. This PyPI-installed CLI scaffolds and compiles Python
projects only and vendors the Python runtime bundled with this wheel.
To start a new project:
mda init my-agent
cd my-agent
uv sync
mda init can shape the project up front — --instructions "..." (or
--instructions-file <path>) writes the system prompt, --scope <boundary>
declares who may call the deployment and how runs are isolated, --model <spec> picks the model, and
--no-sandbox / --no-evals leave parts out. Nothing prompts, so this is also
the command to hand a coding agent or a CI script rather than having it write a
project layout from memory.
mda init my-agent --interactive hands the build to the Deep Agent builder
instead, which interviews you in your terminal.
Define an Agent
Create an agent.py that defines an agent:
from managed_deepagents import define_deep_agent
# The system prompt comes from instructions.md next to this file.
agent = define_deep_agent(
name="research-assistant",
model="openai:gpt-5.5",
tools=[query_db],
)
define_deep_agent requires a static name (LangGraph assistant id and default LangSmith deployment name) and otherwise accepts the create_deep_agent keyword surface minus the managed keys: backend, store, checkpointer, memory, skills, and system_prompt. Those are provided by the managed runtime when your agent is deployed. Write the system prompt in instructions.md next to agent.py; the CLI embeds it at deploy time.
On deploy, Context Hub stores harness files (instructions.md, skills/**) plus a shared agent memory template in the deployment Hub repo. Identity memory is slice-based: the agent slice mounts at /memories/agent/ from the deployment repo, and an optional user slice opens a dedicated Hub repo per caller (lazy-created) at /memories/user/. Hot memory (/memories/agent/AGENTS.md and/or /memories/user/AGENTS.md) is injected every turn for enabled slices. Deploy never overwrites existing memories.
Project Shape
my-agent/
agent.py # named `agent` variable
instructions.md # managed system prompt
pyproject.toml
.env # local deploy secrets, never committed
schedules/ # optional managed cron schedules
tools/ # optional custom tools
middleware/ # optional middleware
skills/ # optional skills synced to Context Hub
sandbox/ # LangSmith sandbox (`mda init` includes this; delete to opt out)
connectors/mcp.py # optional MCP server declaration
The CLI copies your project files into the managed build and generates the entry module that connects your definition to the hosted runtime.
The agent entry must live at the project root as agent.py.
Define a Schedule
Create one file per schedule under schedules/ and define a named schedule:
# schedules/daily_digest.py
from managed_deepagents import define_schedule
schedule = define_schedule(
cron="0 8 * * 1-5",
timezone="America/Los_Angeles",
prompt="Write the daily digest.",
)
mda deploy reconciles schedules as LangSmith cron jobs after the deployment is
live. Declarations must be statically serializable literals or top-level
constants; prompt schedules become user-message input, and stateless runs clean
up their temporary thread after completion.
Sandbox
mda init scaffolds sandbox/__init__.py with a LangSmith sandbox. MDA only
enables the sandbox when that declaration is present — delete sandbox/ to opt
out:
from managed_deepagents import sandboxes
sandbox = sandboxes.langsmith(
scope="thread",
idle_ttl_seconds=600,
)
If sandbox/setup.sh exists, MDA embeds it and runs it once when the sandbox is
first provisioned. MDA owns sandbox naming, image/snapshot selection, reuse, and
lifecycle.
MCP Connectors
Add connectors/mcp.py to attach MCP servers. The file must define a
module-level connector. By default, MDA exposes every tool loaded from each
declared server:
from managed_deepagents import connectors
connector = connectors.mcp(
mcp_servers={
"langchainDocs": {
"transport": "http",
"url": "https://docs.langchain.com/mcp",
"include_tools": ["search", "fetch"],
},
},
)
Use include_tools or exclude_tools inside a server config to select a
subset. Tool names are raw MCP tool names before the managed {server}__ prefix
is applied, so "include_tools": ["search"] on server langchainDocs exposes
langchainDocs__search when prefixing is enabled.
CLI
Create a new project:
mda init my-agent
Build locally:
mda build ./my-agent
Run on the local LangGraph dev server:
mda dev ./my-agent
mda dev requires uv on PATH, but it resolves the local LangGraph dev
server automatically; you do not need to install a global langgraph command.
Deploy to LangSmith:
mda deploy ./my-agent
The generated build is written to <root>/.mda/build by default.
Common deploy options:
mda deploy ./my-agent --name my-agent-dev --deployment-type dev
mda deploy ./my-agent --workspace-id "$LANGSMITH_WORKSPACE_ID"
mda deploy ./my-agent --no-wait
Read the deployed agent's server logs:
mda logs ./my-agent
mda logs ./my-agent --lines 200 --level error
mda logs ./my-agent > agent.log
In a terminal mda logs streams new output until you press Ctrl-C. When the
output is piped or redirected it prints the most recent lines (1000 by default)
and exits.
Tear it down again:
mda delete ./my-agent
mda delete (alias mda destroy) removes the LangSmith deployment, the tracing
project created alongside it, the deployment's Context Hub repo including the
per-user memory repos beneath it, and the managed sandboxes the
deployment created. It asks for confirmation first; pass --yes to skip the
prompt in scripts. Agent memory and thread history are not recoverable
afterwards.
Sandboxes are matched by name: the runtime names each one
{deployment}--{digest}, which also lets a restarted deployment re-adopt its
existing sandbox instead of stranding it. The digest covers the sandbox scope
plus how it was provisioned, so editing setup.sh or switching snapshots gives
the next run a fresh sandbox instead of one built from the previous recipe.
Sandboxes created before this behavior existed are unnamed and are left to
LangSmith's idle-stop and retention window.
Before deploying, make sure your model provider key such as OPENAI_API_KEY
or ANTHROPIC_API_KEY is available in the project .env, the process
environment, or LangSmith workspace secrets. For LangSmith itself, set
LANGSMITH_API_KEY the same way, or run interactively and press Enter at the
prompt to sign in with your browser (the CLI creates a key and writes it to
.env). Use LANGSMITH_WORKSPACE_ID or
--workspace-id when your credentials require a workspace selection.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file managed_deepagents-0.5.0.dev90-py3-none-win_arm64.whl.
File metadata
- Download URL: managed_deepagents-0.5.0.dev90-py3-none-win_arm64.whl
- Upload date:
- Size: 2.0 MB
- Tags: Python 3, Windows ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aff5a6da1e8476cb2901f2e61cd1d378604dd7f330858d83d90bcd0f02375c9c
|
|
| MD5 |
8132c38ee7b631d441254c97bc026b54
|
|
| BLAKE2b-256 |
a1edd5472eeef064e181e2dc99934cc42c2a47aaf408f207cbbf928bfa49e8ab
|
Provenance
The following attestation bundles were made for managed_deepagents-0.5.0.dev90-py3-none-win_arm64.whl:
Publisher:
release.yml on langchain-ai/managed-deepagents-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
managed_deepagents-0.5.0.dev90-py3-none-win_arm64.whl -
Subject digest:
aff5a6da1e8476cb2901f2e61cd1d378604dd7f330858d83d90bcd0f02375c9c - Sigstore transparency entry: 2352215446
- Sigstore integration time:
-
Permalink:
langchain-ai/managed-deepagents-sdk@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/langchain-ai
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file managed_deepagents-0.5.0.dev90-py3-none-win_amd64.whl.
File metadata
- Download URL: managed_deepagents-0.5.0.dev90-py3-none-win_amd64.whl
- Upload date:
- Size: 2.1 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
13888fca7e371407488d77da08fe219eaf0abe7cb7a2a1fabf1df1d2cbbb3310
|
|
| MD5 |
579f90935333b6a62f0774b56bd529bc
|
|
| BLAKE2b-256 |
fe632f416a6141a76421fca993f9fba3973a9e5f91816e7dcbcd67f70008bb56
|
Provenance
The following attestation bundles were made for managed_deepagents-0.5.0.dev90-py3-none-win_amd64.whl:
Publisher:
release.yml on langchain-ai/managed-deepagents-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
managed_deepagents-0.5.0.dev90-py3-none-win_amd64.whl -
Subject digest:
13888fca7e371407488d77da08fe219eaf0abe7cb7a2a1fabf1df1d2cbbb3310 - Sigstore transparency entry: 2352215547
- Sigstore integration time:
-
Permalink:
langchain-ai/managed-deepagents-sdk@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/langchain-ai
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_x86_64.whl.
File metadata
- Download URL: managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_x86_64.whl
- Upload date:
- Size: 2.3 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2814e0655bce55ece3e835cba68f2cb05e38abd9ff4b474f7d832c90882ad525
|
|
| MD5 |
4ce42f7539d948bb2f25260f1927cb01
|
|
| BLAKE2b-256 |
473ee3ded806f54e926e130520ab32649b4d11999ffda3886c7e74b2a2cd74be
|
Provenance
The following attestation bundles were made for managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_x86_64.whl:
Publisher:
release.yml on langchain-ai/managed-deepagents-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_x86_64.whl -
Subject digest:
2814e0655bce55ece3e835cba68f2cb05e38abd9ff4b474f7d832c90882ad525 - Sigstore transparency entry: 2352215327
- Sigstore integration time:
-
Permalink:
langchain-ai/managed-deepagents-sdk@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/langchain-ai
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_aarch64.whl.
File metadata
- Download URL: managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_aarch64.whl
- Upload date:
- Size: 2.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b2d84e2aef9dd43a593105aa08be4ac3103636e55328dd97f73ea1ba08479781
|
|
| MD5 |
471956506d8a628653f90125dfbb7cc9
|
|
| BLAKE2b-256 |
84b985ddf3b4b373a4243c5186136ed61df0c3510535ae5e5a2b8e7205c3c450
|
Provenance
The following attestation bundles were made for managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_aarch64.whl:
Publisher:
release.yml on langchain-ai/managed-deepagents-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
managed_deepagents-0.5.0.dev90-py3-none-manylinux2014_aarch64.whl -
Subject digest:
b2d84e2aef9dd43a593105aa08be4ac3103636e55328dd97f73ea1ba08479781 - Sigstore transparency entry: 2352215910
- Sigstore integration time:
-
Permalink:
langchain-ai/managed-deepagents-sdk@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/langchain-ai
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file managed_deepagents-0.5.0.dev90-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: managed_deepagents-0.5.0.dev90-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 2.0 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
401771d0039bb5334c05493a12bbe05a11146da8acfbdedf3c3492e72bd509fe
|
|
| MD5 |
b339dc2d39bd3aff534d41982a36d68e
|
|
| BLAKE2b-256 |
bdf1c1152d8ebf09f426591220d445ab065b4c92022d61497f3badab7603e985
|
Provenance
The following attestation bundles were made for managed_deepagents-0.5.0.dev90-py3-none-macosx_11_0_arm64.whl:
Publisher:
release.yml on langchain-ai/managed-deepagents-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
managed_deepagents-0.5.0.dev90-py3-none-macosx_11_0_arm64.whl -
Subject digest:
401771d0039bb5334c05493a12bbe05a11146da8acfbdedf3c3492e72bd509fe - Sigstore transparency entry: 2352215666
- Sigstore integration time:
-
Permalink:
langchain-ai/managed-deepagents-sdk@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/langchain-ai
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file managed_deepagents-0.5.0.dev90-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: managed_deepagents-0.5.0.dev90-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 2.1 MB
- Tags: Python 3, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ac38676923378672bc18062ee360743d0713a16adc0590da6db080b818cd5dee
|
|
| MD5 |
41a7f47244ac145bae63f30e8e25cdb9
|
|
| BLAKE2b-256 |
72db3df67db7617d9d2e20ccf8d8b7b4b6367d5ee22f4cf8764402dfe1ef02b0
|
Provenance
The following attestation bundles were made for managed_deepagents-0.5.0.dev90-py3-none-macosx_10_12_x86_64.whl:
Publisher:
release.yml on langchain-ai/managed-deepagents-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
managed_deepagents-0.5.0.dev90-py3-none-macosx_10_12_x86_64.whl -
Subject digest:
ac38676923378672bc18062ee360743d0713a16adc0590da6db080b818cd5dee - Sigstore transparency entry: 2352215778
- Sigstore integration time:
-
Permalink:
langchain-ai/managed-deepagents-sdk@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/langchain-ai
-
Access:
internal
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c3d0c60efe68bd28cc271a0f147f73f08248d12 -
Trigger Event:
workflow_dispatch
-
Statement type: