deepagents-cli

library0.0.46pypypiunverified

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.

llm-agents ai-ml

pip install deepagents-cli

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · DEEPAGENTS-CLI

deepagents-cli

llm-agentspythonv0.0.46

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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.")

deepagents --version

Debug

Known issues

breakingThe `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`

affects: <0.0.46

gotchaRunning `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`.

affects: all

deprecatedThe 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`

affects: deepagents>=0.5.0

gotchaMCP 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

affects: >=0.0.46

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'deepagents_cli'

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`

deepagents: command not found

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

fix

Install the CLI package: `pip install deepagents-cli`

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

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.

Upgrade

Version history

0.0.46latest on PyPI · released Apr 30, 2026

Audit

Dependencies

deepagentsrequiredCore agent harness and prompt profiles

Agent activity

17 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/langchain-ai/deepagents ↗

packagehttps://pypi.org/project/deepagents-cli/ ↗

homepagehttps://docs.langchain.com/oss/python/deepagents/overview ↗

docshttps://reference.langchain.com/python/deepagents/ ↗

changeloghttps://github.com/langchain-ai/deepagents/blob/main/libs/cli/CHANGELOG.md ↗