Skip to content
Back to search

deepagents

The batteries-included agent harness.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/langchain-ai/deepagents with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/langchain-ai/deepagents'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/langchain-ai--deepagents/badge.svg)](/listings/langchain-ai--deepagents)

HTML

<a href="/listings/langchain-ai--deepagents"><img src="/api/listings/langchain-ai--deepagents/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

uv add deepagents
from deepagents import create_deep_agent

agent = create_deep_agent(
    model="openai:gpt-6-astra",
    system_prompt="You are a research assistant.",
)
result = agent.invoke({"messages": "Research LangGraph and write a summary"})

The agent can plan, read/write files, and manage its own context. Add your own tools, swap models, customize prompts, configure sub-agents, and more. See the [documentation](https://docs.langchain.com/oss/python/deepagents/overview) for full details.

> [!TIP] > For developing, debugging, and deploying AI agents and LLM applications, see [LangSmith](https://docs.langchain.com/langsmith/home).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 115 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <a href="https://docs.langchain.com/oss/python/deepagents/overview#deep-agents-overview">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset=".github/images/logo-dark.svg">
  5. <source media="(prefers-color-scheme: light)" srcset=".github/images/logo-light.svg">
  6. <img alt="Deep Agents Logo" src=".github/images/logo-dark.svg" width="50%">
  7. </picture>
  8. </a>
  9. </div>
  10. <div align="center">
  11. <h3>The batteries-included agent harness.</h3>
  12. </div>
  13. <div align="center">
  14. <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/pypi/l/deepagents" alt="PyPI - License"></a>
  15. <a href="https://pypistats.org/packages/deepagents" target="_blank"><img src="https://img.shields.io/pepy/dt/deepagents" alt="PyPI - Downloads"></a>
  16. <a href="https://pypi.org/project/deepagents/#history" target="_blank"><img src="https://img.shields.io/pypi/v/deepagents?label=%20" alt="Version"></a>
  17. <a href="https://x.com/langchain_oss" target="_blank"><img src="https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain" alt="Twitter / X"></a>
  18. </div>
  19. <br>
  20. Deep Agents is an open source agent harness — an opinionated agent that runs out of the box. Extend, override, or replace any piece.
  21. **Principles:**
  22. - **Opinionated** — defaults tuned for long-horizon, multi-step work
  23. - **Extensible** — override or replace any piece without forking
  24. - **Model-agnostic** — works with any LLM that supports tool calling: frontier, open-weight, or local
  25. - **Production-ready** — built on LangGraph (streaming, persistence, checkpointing) with first-class tracing, evaluation, and deployment via LangSmith
  26. **Features include:**
  27. - **Sub-agents** — delegate tasks to agents with isolated context windows
  28. - **Filesystem** — read, write, edit, or search over pluggable local, sandboxed, or remote backends
  29. - **Context management** — summarize long threads and offload tool outputs to disk
  30. - **Shell access** — run commands in your sandbox of choice
  31. - **Persistent memory** — pluggable state and store backends for cross-session recall
  32. - **Human-in-the-loop** — approve, edit, or reject tool calls before they run
  33. - **Skills** — reusable behaviors the agent can load on demand
  34. - **Tools** — bring your own functions or any MCP server
  35. Deep Agents is available as a JavaScript/TypeScript library — see [deepagents.js](https://github.com/langchain-ai/deepagentsjs).
  36. > [!NOTE]
  37. > **Deep Agents Code** — a pre-built coding agent in your terminal, similar to Claude Code or Cursor, powered by any LLM. Install with `curl -LsSf https://langch.in/dcode | bash`. See the [documentation](https://docs.langchain.com/deepagents-code) for the full feature set.
  38. ## Quickstart
  39. ```bash
  40. uv add deepagents
  41. ```
  42. ```python
  43. from deepagents import create_deep_agent
  44. agent = create_deep_agent(
  45. model="openai:gpt-6-astra",
  46. system_prompt="You are a research assistant.",
  47. )
  48. result = agent.invoke({"messages": "Research LangGraph and write a summary"})
  49. ```
  50. The agent can plan, read/write files, and manage its own context. Add your own tools, swap models, customize prompts, configure sub-agents, and more. See the [documentation](https://docs.langchain.com/oss/python/deepagents/overview) for full details.
  51. > [!TIP]
  52. > For developing, debugging, and deploying AI agents and LLM applications, see [LangSmith](https://docs.langchain.com/langsmith/home).
  53. ## FAQ
  54. ### How is this different from LangGraph or LangChain?
  55. LangGraph is the graph runtime. LangChain's `create_agent` is a minimal agent harness on top of it. Deep Agents is a more opinionated harness on top of `create_agent` — same building blocks, but with filesystem, sub-agents, context management, and skills bundled in. For how the three relate, see the [LangChain ecosystem overview](https://docs.langchain.com/oss/python/concepts/products).
  56. ### Does this work with open-weight or local models?
  57. Yes. Any model that supports tool calling works — frontier APIs (OpenAI, Anthropic, Google), open-weight models hosted on providers like Baseten or Fireworks, and self-hosted models via Ollama, vLLM, or llama.cpp. Use any [LangChain chat model](https://docs.langchain.com/oss/python/langchain/models).
  58. ### Can I use this in production?
  59. Yes! Deep Agents is built on LangGraph, designed for production agent deployments. Pair it with [LangSmith](https://docs.langchain.com/langsmith/home) for tracing, evaluation, and monitoring. See [Going to production](https://docs.langchain.com/oss/python/deepagents/going-to-production) for the full guide.
  60. ### When should I use Deep Agents vs. LangChain or LangGraph directly?
  61. All three are layers in the same stack — see the [LangChain ecosystem overview](https://docs.langchain.com/oss/python/concepts/products) for how they relate. Use **Deep Agents** when you want the full harness — planning, context management, delegation — out of the box. Use [**LangChain's `create_agent`**](https://docs.langchain.com/oss/python/langchain/agents) when you want a lighter harness without the bundled middleware. Drop to [**LangGraph**](https://docs.langchain.com/oss/python/langgraph/overview) when the agent loop itself isn't the right shape and you need a custom graph.
  62. The layers compose: any LangGraph `CompiledStateGraph` can be passed in as a sub-agent to a Deep Agent, so custom orchestration plugs in alongside the harness's defaults.
  63. ---
  64. ## Resources
  65. - [Examples](https://github.com/langchain-ai/deepagents/tree/main/examples#readme) — working agents and patterns
  66. - [Documentation](https://docs.langchain.com/oss/python/deepagents/overview) — conceptual overviews and guides
  67. - [Changelog](libs/deepagents/CHANGELOG.md) — release notes for the Python SDK
  68. - [LangChain ecosystem overview](https://docs.langchain.com/oss/python/concepts/products) — how Deep Agents, LangChain, LangGraph, and LangSmith fit together
  69. - [API reference](https://reference.langchain.com/python/deepagents/) — complete reference for all public classes, functions, and types
  70. - [Discussions](https://forum.langchain.com/c/oss-product-help-lc-and-lg/deep-agents/18) — community forum for technical questions, ideas, and feedback
  71. - [LangChain Academy](https://academy.langchain.com/) — Comprehensive, free courses on LangChain libraries and products, made by the LangChain team.
  72. - [Development Guide](libs/DEVELOPMENT.md) — local setup and package-specific checks
  73. - [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview) — how to contribute and find good first issues
  74. - [Release policy](https://docs.langchain.com/oss/python/release-policy) — releases and support
  75. - [Versioning policy](https://docs.langchain.com/oss/python/versioning) — version numbering and compatibility
  76. - [Code of Conduct](https://github.com/langchain-ai/langchain/?tab=coc-ov-file) — community guidelines and standards
  77. ---
  78. ## Acknowledgements
  79. Inspired by Claude Code: an attempt to identify what makes it general-purpose, and push that further.
  80. ## Security
  81. Deep Agents follows a "trust the LLM" model. The agent can do anything its tools allow. Enforce boundaries at the tool/sandbox level, not by expecting the model to self-police. See the [security policy](https://github.com/langchain-ai/deepagents?tab=security-ov-file) for more information.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.