deep-agents
/deep-agents
Build batteries-included agents with planning, context management, subagent delegation, and sandboxed execution. Use for complex, multi-step tasks that need built-in capabilities.
- Author
- langchain-ai ↗
- Repository
- docs ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 14
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Build batteries-included agents with planning, context management, subagent delegation, and sandboxed execution. Use for complex, multi-step tasks that need built-in capabilities.
Original author description
Build batteries-included agents with planning, context management, subagent delegation, and sandboxed execution. Use for complex, multi-step tasks that need built-in capabilities.
How it works
- When to use
- When NOT to use
- Install
- Quick reference
- Key documentation
- API reference
- Related skills
SKILL.md preview
---
name: deep-agents
description: Build batteries-included agents with planning, context management, subagent delegation, and sandboxed execution. Use for complex, multi-step tasks that need built-in capabilities.
license: MIT
compatibility: Python 3.10+, Node.js 22+. Requires a model that supports tool calling.
metadata:
author: langchain-ai
version: "1.0"
---
# Deep Agents
Deep Agents is the easiest way to start building agents powered by LLMs—with built-in capabilities for task planning, file systems for context management, subagent delegation, and long-term memory. It is an "agent harness" built on [LangChain](https://docs.langchain.com/oss/langchain/overview) core building blocks and the [LangGraph](https://docs.langchain.com/oss/langgraph/overview) runtime.
## When to use
Use Deep Agents when you need to:
- **Build agents fast** with sensible defaults and minimal configuration
- **Handle complex, multi-step tasks** that benefit from automatic planning
- **Manage context** with a built-in virtual filesystem for large inputs
- **Delegate subtasks** to specialized subagents
- **Run code safely** in sandboxed execution environments
- **Use a terminal agent** via Deep Agents Code
## When NOT to use
- For simple tool-calling agents without planning or subagents, use [LangChain](https://docs.langchain.com/oss/langchain/overview) agents instead—lighter weight
- For custom graph-based orchestration with explicit control flow, use [LangGraph](https://docs.langchain.com/oss/langgraph/overview) directly
- Deep Agents is the **highest-level abstraction**—it trades flexibility for convenience
## Install
```bash
# Python
pip install deepagents
# JavaScript/TypeScript
npm install deepagents langchain @langchain/core
```
## Quick reference
### Create a deep agent
```python
# pip install deepagents langchain-anthropic
from deepagents import create_deep_agent
def get_weather(city: str) -> str:
"""Get weather for a given city."""
return f"It's always sunny in {city}!"
agent = create_deep_agent(
model="anthropic:claude-sonnet-4-6",
tools=[get_weather],
system_prompt="You are a helpful assistant",
)
result = agent.invoke(
{"messages": [{"role": "user", "content": "What is the weather in SF?"}]}
)
```
### Use Deep Agents Code
```bash
# Install Deep Agents Code
pip install deepagents-code
# Run an interactive terminal agent
deepagents
```
### Built-in capabilities
| Capability | Description |
|-----------|-------------|
| Planning | Automatic task decomposition for complex requests |
| File system | Virtual filesystem for reading, writing, and managing context |
| Subagents | Spawn child agents for parallel subtask execution |
| Context management | Automatic context compression for long conversations |
| Sandboxed execution | Run code in isolated environments (Modal, Runloop, Daytona) |
| Protocols | ACP, MCP, and A2A support for interoperability |
## Key documentation
- [Overview](https://docs.langchain.com/oss/python/deepagents/overview)—What Deep Agents is and how it compares to LangChain and LangGraph
- [Quickstart](https://docs.langchain.com/oss/python/deepagents/quickstart)—Build your first deep agent
- [Customization](https://docs.langchain.com/oss/python/deepagents/customization)—Configure models, tools, and behavior
- [Context engineering](https://docs.langchain.com/oss/python/deepagents/context-engineering)—Manage context for complex tasks
- [Subagents](https://docs.langchain.com/oss/python/deepagents/subagents)—Delegate work to child agents
- [Sandboxes](https://docs.langchain.com/oss/python/deepagents/sandboxes)—Run code in isolated environments
- [Code](https://docs.langchain.com/oss/deepagents/code/overview)—Deep Agents Code, the terminal agent interface
- [Deploy](https://docs.langchain.com/langsmith/managed-deep-agents-overview)—Deploy to production
## API reference
For SDK class and method details, use the [LangChain API Reference](https://reference.langchain.com) site:
- MCP server: `https://reference.langchain.com/mcp`
## Related skills
- **langchain**—Core building blocks that Deep Agents is built on
- **langgraph**—Runtime that powers Deep Agents' durable execution
- **langsmith**—Trace, evaluate, and deploy your deep agents
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · langchain-ai/docs | 100 | MIT |
| laurigates/claude-plugins | 100 | MIT |
Database snapshot: 13.11.2026 · package version bc380ffee98f (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100subagent-creator
Guide for creating AI subagents with isolated context for complex multi-step workflows. Use when users want to create a subagent, specialized agent, verifier, debugger, or orchestrator that requires isolated context and deep specialization. Works with any agent that supports… - 100agent-coordination
Multi-agent orchestration with model routing, category delegation, and sprint management. Use for coordinating Pantheon agents. - 100planning-with-files
Implements Manus-style file-based planning for complex tasks. Creates task_plan.md, findings.md, and progress.md. Use when starting complex multi-step tasks, research projects, or any task requirin... - 100planning
Plan multi-step AI agent work: decompose goals, sequence agents, define handoffs, and handle failure. Use when orchestrating agents through complex tasks that need structure before execution. - 100agent-context-budget-management-strategies
Use this skill when monitoring, budgeting, and optimizing context window tokens during complex, multi-turn technical workflows. - 100hosted-agents
Build and deploy hosted background coding agents with sandboxed VM execution, multiplayer sessions, and multi-client interfaces. Use when the user asks to "build background agent", "create hosted coding agent", "set up sandboxed execution", "implement multiplayer agent", or…