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
Что это такое?LangGraph — это низкоуровневый фреймворк для создания, управления и развёртывания долгоживущих агентов с сохранением состояния — то есть рабочих процессов, где агент хранит состояние между шагами, сбоями и даже сессиями.
Это фреймворк, под который я пишу код, или готовое приложение?Это фреймворк: вы пишете код на Python поверх его рантайма, а не запускаете готовый продукт. Есть и аналог для JS/TS — библиотека LangGraph.js, если вам ближе JavaScript.
С чего начать разработку с ним?Пройдите LangGraph Quickstart в официальной документации на docs.langchain.com — там пошагово показано, как добавить пакет в свой Python-проект и собрать первого агента.
Мне обязательно брать весь стек LangChain целиком?Нет — его создала LangChain Inc, но он полностью самостоятелен. Просто он бесшовно интегрируется с продуктами LangChain, такими как Deep Agents, LangChain и LangSmith, если вам нужен более полный набор инструментов.
Звучит низкоуровнево — мне придётся собирать всё самому?Да, он даёт всю инфраструктуру, а логику агента вы строите на ней сами. Если хочется это пропустить, в README рекомендуют Deep Agents — пакет уровнем выше, построенный на LangGraph, для агентов, которые планируют, используют подагентов и работают с файловыми системами.
Что LangGraph делает для моего агента во время работы?Три главные вещи: отказоустойчивое выполнение (агент переживает сбои и возобновляется ровно с того места, где остановился), контроль человека (можно в любой момент посмотреть и изменить состояние агента) и память — как краткосрочная рабочая, так и долговременная, сохраняющаяся между сессиями.
Он реально проверен в продакшене?Да — он прямо позиционируется для развёртывания долгоживущих рабочих процессов с состоянием в масштабе, а в README среди использующих его компаний названы Klarna, Replit и Elastic.
Как отлаживать агента, если он делает что-то неожиданное?Используйте его вместе с LangSmith: он трассирует пути выполнения, фиксирует переходы состояния и показывает подробные метрики рантайма, так что вы видите, что сложный агент на самом деле делал. LangSmith также покрывает оценку качества (evals) и наблюдаемость в продакшене.
Где выучить LangGraph, если документация кажется тяжёлой?LangChain Academy предлагает бесплатный структурированный курс по основам LangGraph, а в документации есть короткие практические гиды по темам вроде стриминга, добавления памяти и персистентности, а также паттернов проектирования, таких как ветвление и подграфы.
На каких идеях построен LangGraph?Он вдохновлён Pregel и Apache Beam, а его публичный интерфейс берёт пример с NetworkX — графовых моделей для надёжных долгоживущих вычислений.
Для чего нужен LangSmith Deployment?Это специализированная платформа для развёртывания и масштабирования долгоживущих агентов с состоянием: команды могут находить, переиспользовать, настраивать и делиться агентами, а также быстро итерировать с визуальным прототипированием в LangSmith Studio.
Size
516.5 MB
Stars
43.4K
Age
3y
Commits · 90 Days