langgraph README

The project's README from github.com/langchain-ai/langgraph. As one markdown file: README.md.

LangGraph Logo

Low-level orchestration framework for building stateful agents.

PyPI - License PyPI - Downloads Version Twitter / X

Trusted by companies shaping the future of agents – including Klarna, Replit, Elastic, and more – LangGraph is a low-level orchestration framework for building, managing, and deploying long-running, stateful agents.

pip install -U langgraph

[!TIP] If you're looking to quickly build agents, check out Deep Agents — a higher-level package built on LangGraph for agents that can plan, use subagents, and leverage file systems for complex tasks.

For an equivalent JS/TS library, check out LangGraph.js and the JS docs.

Why use LangGraph?

LangGraph provides low-level supporting infrastructure for any long-running, stateful workflow or agent:

[!TIP] For developing, debugging, and deploying AI agents and LLM applications, see LangSmith.

LangGraph ecosystem

While LangGraph can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools for building agents.

To improve your LLM application development, pair LangGraph with:


Documentation

Discussions: Visit the LangChain Forum to connect with the community and share all of your technical questions, ideas, and feedback.

Additional resources


Acknowledgements

LangGraph is inspired by Pregel and Apache Beam. The public interface draws inspiration from NetworkX. LangGraph is built by LangChain Inc, the creators of LangChain, but can be used without LangChain.

langgraph (langchain-ai/langgraph)

Searching Database…

43.4K ·GitHub
What is this?LangGraph is a low-level orchestration framework for building, managing, and deploying long-running, stateful AI agents — workflows where an agent keeps state across steps, failures, and even sessions.
Is this a framework I code against, or a ready-made app?It is a framework: you write Python code on top of its runtime rather than launch a finished product. There is also an equivalent JS/TS library, LangGraph.js, if you prefer JavaScript.
How do I get started building with it?Follow the LangGraph Quickstart in the official docs at docs.langchain.com — it walks you through adding the package to your Python project and building your first agent.
Do I have to adopt the whole LangChain stack to use it?No — it is built by LangChain Inc but works fully standalone. It just integrates seamlessly with LangChain products like Deep Agents, LangChain, and LangSmith if you want the fuller toolkit.
It sounds low-level — do I have to assemble everything myself?Yes, it provides the supporting infrastructure and you build the agent logic on it. If you want to skip that, the README points to Deep Agents, a higher-level package built on LangGraph for agents that plan, use subagents, and leverage file systems.
What does LangGraph handle for my agent while it runs?Three core things: durable execution (the agent persists through failures and resumes exactly where it left off), human-in-the-loop oversight (inspect and modify agent state at any point), and memory — both short-term working memory and long-term persistent memory across sessions.
Is it actually proven in production?Yes — it is explicitly positioned for deploying long-running, stateful workflows at scale, and the README names Klarna, Replit, and Elastic among the companies using it.
How do I debug an agent when it does something unexpected?Pair it with LangSmith: it traces execution paths, captures state transitions, and shows detailed runtime metrics so you can see what a complex agent actually did. LangSmith also covers evals and production observability.
Where can I learn LangGraph if the docs feel heavy?LangChain Academy offers a free, structured course covering the basics of LangGraph, and the docs also include quick, actionable guides for topics like streaming, adding memory and persistence, and design patterns such as branching and subgraphs.
What ideas is LangGraph built on?It is inspired by Pregel and Apache Beam, and its public interface draws inspiration from NetworkX — graph-based models for reliable, long-running computation.
What is LangSmith Deployment for?It is a purpose-built platform for deploying and scaling long-running, stateful agents: teams can discover, reuse, configure, and share agents, and iterate quickly with visual prototyping in LangSmith Studio.
Size
516.6 MB
Stars
43.4K
Age
3y
Commits · 90 Days