{"id":23534,"library":"deepagents-cli","title":"Deep Agents CLI","description":"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.","status":"active","version":"0.0.46","language":"python","source_language":"en","source_url":"https://github.com/langchain-ai/deepagents","tags":["cli","ai-agent","terminal","langchain","mcp"],"install":[{"cmd":"pip install deepagents-cli","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"Core agent harness and prompt profiles","package":"deepagents","optional":false}],"imports":[],"quickstart":{"code":"import os\nos.environ['ANTHROPIC_API_KEY'] = os.environ.get('ANTHROPIC_API_KEY', '')\nfrom deepagents_cli import run\n# This starts the interactive CLI; typically run from command line: deepagents\n# If running as script, use:\n# run()\nprint(\"Configured -- launch via `deepagents` terminal command.\")","lang":"python","description":"Import and use the main entry point. The CLI is typically invoked via the `deepagents` command after installation."},"warnings":[{"fix":"Upgrade both packages: `pip install --upgrade deepagents deepagents-cli`","message":"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.","severity":"breaking","affected_versions":"<0.0.46"},{"fix":"Set the appropriate environment variable before launching. Example: `export ANTHROPIC_API_KEY='sk-...'` then `deepagents`.","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"Install `deepagents-cli` to get the `deepagents` command. `pip install deepagents-cli`","message":"The old `deepagents` command (from core package) is deprecated in favor of the CLI package. Installing `deepagents` alone no longer provides the terminal command.","severity":"deprecated","affected_versions":"deepagents>=0.5.0"},{"fix":"Check `allowedTools`/`disabledTools` in MCP config to filter unwanted tools. See https://github.com/langchain-ai/deepagents/blob/main/docs/mcp.md","message":"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.","severity":"gotcha","affected_versions":">=0.0.46"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Ensure you installed `deepagents-cli` (with dash) but import using underscore: `from deepagents_cli import run`","cause":"The package is installed but the import path is incorrect; the module is named `deepagents_cli` (with an underscore).","error":"ModuleNotFoundError: No module named 'deepagents_cli'"},{"fix":"Install the CLI package: `pip install deepagents-cli`","cause":"The `deepagents` command is provided by the `deepagents-cli` package, not the core `deepagents` package.","error":"deepagents: command not found"},{"fix":"Do not import from `deepagents.cli`. Install and use `deepagents-cli` instead.","cause":"The core `deepagents` package does not contain a CLI module. The CLI has been split into a separate package.","error":"AttributeError: module 'deepagents' has no attribute 'cli'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}