How langchain-ai/deepagents works
Deep Agents is a batteries-included, model-agnostic agent harness. A user submits a task through the core graph or the terminal coding client; the agent invokes an LLM, applies middleware, delegates work, uses tools and files, persists state, and streams a result. The repository also provides ACP and MCP-facing interfaces. The graph reflects README capabilities and sampled orchestration code; some internal call paths are inferred only from documented subsystem boundaries.
Main entry points: graph.py Agent Graph · _tools.py Tool Catalog · __init__.py Middleware Stack · main.py Code CLI
Components 21
Agent Core
- Agent Graph
libs/deepagents/deepagents/graph.py - Model Profiles
libs/deepagents/deepagents/profiles/provider/provider_profiles.py - Middleware Stack
libs/deepagents/deepagents/middleware/__init__.py - Agent Result
libs/deepagents/deepagents/graph.py
Agent Capabilities
- Tool Catalog
libs/deepagents/deepagents/_tools.py - Filesystem Tools
libs/deepagents/deepagents/middleware/filesystem.py - Shell Backend
libs/deepagents/deepagents/backends/local_shell.py - Sub-agents
libs/deepagents/deepagents/middleware/subagents.py - Skills
libs/deepagents/deepagents/middleware/skills.py - Tool Permissions
libs/deepagents/deepagents/middleware/permissions.py
State Context
- Context Manager
libs/deepagents/deepagents/middleware/summarization.py - Persistent Memory
libs/deepagents/deepagents/middleware/memory.py - State Store
libs/deepagents/deepagents/backends/store.py
Coding Client
- Code CLI
libs/code/deepagents_code/main.py - Remote Agent Client
libs/code/deepagents_code/client/remote_client.py - Server Manager
libs/code/deepagents_code/client/launch/server_manager.py - Hooks Engine
libs/code/deepagents_code/hooks/engine.py
External Interfaces
- ACP Server
libs/acp/deepagents_acp/server.py - MCP Tools
libs/code/deepagents_code/mcp_tools.py
Other components
- User
- Chat Model
Connections 24
- User → Agent Graph: submits task
- Agent Graph → Model Profiles: resolves model
- Agent Graph → Chat Model: calls model
- Agent Graph → Middleware Stack: runs middleware
- Middleware Stack → Tool Catalog: exposes tools
- Middleware Stack → Context Manager: manages context
- Middleware Stack → Tool Permissions: checks approval
- Tool Catalog → Filesystem Tools: dispatches tools
- Tool Catalog → Shell Backend: runs commands
- Tool Catalog → Sub-agents: delegates tasks
- Tool Catalog → Skills: loads skills
- Filesystem Tools → State Store: reads and writes
- Persistent Memory → State Store: stores recall
- Context Manager → State Store: offloads context
- Agent Graph → Persistent Memory: uses memory
- Agent Graph → Agent Result: returns result
- User → Code CLI: starts coding
- Code CLI → Server Manager: starts server
- Server Manager → Remote Agent Client: creates client
- Remote Agent Client → Agent Graph: invokes graph
- Code CLI → Hooks Engine: coordinates hooks
- ACP Server → Agent Graph: serves agent
- MCP Tools → Tool Catalog: adds tools
- Agent Graph → Chat Model: traces via LangSmith