diff --git a/src/oss/deepagents/overview.mdx b/src/oss/deepagents/overview.mdx
index ebcb4892a1..3bdb5c9594 100644
--- a/src/oss/deepagents/overview.mdx
+++ b/src/oss/deepagents/overview.mdx
@@ -4,7 +4,13 @@ sidebarTitle: Overview
description: Build agents that can plan, use subagents, and leverage file systems for complex tasks
---
+:::python
[`deepagents`](https://pypi.org/project/deepagents/) is a standalone library for building agents that can tackle complex, multi-step tasks. Built on LangGraph and inspired by applications like Claude Code, Deep Research, and Manus, deep agents come with planning capabilities, file systems for context management, and the ability to spawn subagents.
+:::
+
+:::js
+[`deepagents`](https://www.npmjs.com/package/deepagents) is a standalone library for building agents that can tackle complex, multi-step tasks. Built on LangGraph and inspired by applications like Claude Code, Deep Research, and Manus, deep agents come with planning capabilities, file systems for context management, and the ability to spawn subagents.
+:::
## When to use deep agents
@@ -14,7 +20,13 @@ Use deep agents when you need agents that can:
- **Delegate work** to specialized subagents for context isolation
- **Persist memory** across conversations and threads
+:::python
For simpler use cases, consider using LangChain's [`create_agent`](/oss/langchain/agents) or building a custom [LangGraph](/oss/langgraph/overview) workflow.
+:::
+
+:::js
+For simpler use cases, consider using LangChain's [`createAgent`](/oss/langchain/agents) or building a custom [LangGraph](/oss/langgraph/overview) workflow.
+:::
## Core capabilities
@@ -42,6 +54,7 @@ Deep agents applications can be deployed via [LangSmith Deployment](/langsmith/d
## Get started
+:::python
Build your first deep agent
@@ -56,3 +69,21 @@ Deep agents applications can be deployed via [LangSmith Deployment](/langsmith/d
See the `deepagents` API reference
+:::
+
+:::python
+
+
+ Build your first deep agent
+
+
+ Learn about customization options
+
+
+ Understand the middleware architecture
+
+
+ See the `deepagents` API reference
+
+
+:::