langchain-cli

library0.0.37pypypi✓ verified 84d ago

The official CLI for scaffolding, interacting, and managing LangChain projects. Version 0.0.37, requires Python >=3.9. Release cadence is irregular; active development.

llm-agents ai-ml devops

pip install langchain-cli

github ↗package ↗homepage ↗changelog ↗

INSTALL

IMPORT

SIG · LANGCHAIN-CLI

langchain-cli

llm-agentspythonv0.0.37

Install

9.2s avg

Import

109ms

Disk

94MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.0.37 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.114s · 90.4MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 9.2s · import 0.103s · 99MB

94MB installed

● package 94MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

langchain_cli

✓ import langchain_cli

✗ import langchaincli

The package name has an underscore, not a hyphen.

langchain_cli.cli

✓ from langchain_cli.cli import app

✗ from langchain.cli import app

The main module is under langchain_cli, not langchain.

Test CLI invocation programmatically. Shows the installed version.

import langchain_cli from langchain_cli.cli import app from typer.testing import CliRunner runner = CliRunner() result = runner.invoke(app, ["--version"]) print(result.output.strip())

langchain --version

Debug

Known issues

deprecatedThe `langchain` pip package itself is not needed for the CLI. Installing both can cause conflicts.

fix

Install langchain-cli without langchain unless you specifically need the full SDK.

affects: all

gotchaThe CLI uses Typer under the hood. Do not try to import from `langchain_cli` if you only installed `langchain` — you need a separate install.

fix

Ensure `pip list | grep langchain-cli` shows the package.

affects: all

breakingIn v0.0.30+, the `langchain-cli serve` command was renamed to `langchain-cli run`. Old scripts using `serve` will break.

fix

Replace `langchain-cli serve` with `langchain-cli run` in your commands.

affects: >=0.0.30

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'langchain_cli'

Package not installed or installed under different name (langchain-cli vs langchain_cli).

fix

Run `pip install langchain-cli` and import using `import langchain_cli`.

Error: No such command 'serve'

The `serve` command was renamed to `run` in v0.0.30+.

fix

Use `langchain-cli run` instead of `langchain-cli serve`.

Usage: langchain-cli [OPTIONS] COMMAND [ARGS]... Try 'langchain-cli --help' for help. Error: Missing argument 'COMMAND'.

Running `langchain-cli` without any subcommand.

fix

Provide a valid subcommand like `new`, `run`, or `--help`.

Upgrade

Version history

0.0.37latest on PyPI · released Aug 30, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

17 hits · last 30 days

node

OpenAI (training)

Resources

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

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

homepagehttps://langchain.com ↗

changeloghttps://github.com/langchain-ai/langchain/releases?q=tag%3A%22langchain-cli%3D%3D0%22&expanded=true ↗