Deep Agents CLI

0.0.46 verified Fri May 01 auth: no python

Terminal interface for LangChain's Deep Agents framework. Provides an interactive REPL with file operations, shell access, sub-agent spawning, and MCP integration. Current version: 0.0.46, supports Python ≥3.11. Releases occur weekly.

pip install deepagents-cli

Common errors

error ModuleNotFoundError: No module named 'deepagents_cli' ↓

cause The package is installed but the import path is incorrect; the module is named `deepagents_cli` (with an underscore).

fix

Ensure you installed deepagents-cli (with dash) but import using underscore: from deepagents_cli import run

error deepagents: command not found ↓

cause The `deepagents` command is provided by the `deepagents-cli` package, not the core `deepagents` package.

fix

Install the CLI package: pip install deepagents-cli

error AttributeError: module 'deepagents' has no attribute 'cli' ↓

cause The core `deepagents` package does not contain a CLI module. The CLI has been split into a separate package.

fix

Do not import from deepagents.cli. Install and use deepagents-cli instead.

Warnings

breaking The `deepagents-cli` package versioning diverged from `deepagents` core. Ensure you install `deepagents-cli>=0.0.46` with `deepagents>=0.5.5` to avoid compatibility issues. ↓

fix Upgrade both packages: `pip install --upgrade deepagents deepagents-cli`

gotcha Running `deepagents` without a model provider key (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY) will exit with an error. The CLI does not prompt for missing keys. ↓

fix Set the appropriate environment variable before launching. Example: `export ANTHROPIC_API_KEY='sk-...'` then `deepagents`.

deprecated The old `deepagents` command (from core package) is deprecated in favor of the CLI package. Installing `deepagents` alone no longer provides the terminal command. ↓

fix Install `deepagents-cli` to get the `deepagents` command. `pip install deepagents-cli`

gotcha MCP configuration in `~/.config/deepagents/mcp.json` or project-level `AGENTS.md` may cause unexpected tool loading. Tools from configured MCP servers are automatically merged. ↓

fix Check `allowedTools`/`disabledTools` in MCP config to filter unwanted tools. See https://github.com/langchain-ai/deepagents/blob/main/docs/mcp.md

Quickstart

Import and use the main entry point. The CLI is typically invoked via the `deepagents` command after installation.

import os
os.environ['ANTHROPIC_API_KEY'] = os.environ.get('ANTHROPIC_API_KEY', '')
from deepagents_cli import run
# This starts the interactive CLI; typically run from command line: deepagents
# If running as script, use:
# run()
print("Configured -- launch via `deepagents` terminal command.")