langgraph-supervisor
An implementation of a supervisor multi-agent architecture using LangGraph
Decision gist · record as of 2026-08-14
Yes, if you are building a hierarchical multi-agent system and prefer a structured abstraction over manual tool-calling. The library is actively maintained, has low install friction, and integrates well with LangGraph's ecosystem. However, review the library's own recommendation to use tool-calling directly for most new projects—install this primarily to upgrade existing code or when the supervisor abstraction clearly simplifies your architecture.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >= 3.10.
- Requires langchain-core and langgraph to be installed and configured with a working LLM model.
- Low install friction with only two runtime dependencies (langgraph and langchain-core).
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, making it suitable for most production deployments.
last release 2025-11-19 (268 days) · last repo commit 2026-07-15 · 1,640 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 718,713 downloads/mo, #5,242 on PyPI
Alternatives
Verify before relying
pip install langgraph-supervisor
from langgraph_supervisor import create_supervisor
from langgraph.prebuilt import create_react_agent
math_agent = create_react_agent(model=model, tools=[add, multiply], name="math_expert")
research_agent = create_react_agent(model=model, tools=[web_search], name="research_expert")
workflow = create_supervisor([research_agent, math_agent], model=model)
app = workflow.compile()
result = app.invoke({"messages": [{"role": "user", "content": "query"}]})- Whether the library's supervisor pattern remains the recommended approach given the note recommending tool-calling directly for most use cases
- Performance characteristics when managing large numbers of agents or deeply nested hierarchies
- Compatibility guarantees with specific langgraph and langchain-core versions beyond the stated requirements
What it is and what it does
langgraph-supervisor provides a Python library for building hierarchical multi-agent systems on top of LangGraph. It implements a supervisor pattern where a central agent orchestrates communication and task delegation to specialized worker agents. The supervisor makes routing decisions based on context and task requirements, controlling all message flow between agents.
The library handles the mechanics of agent coordination—tool-based handoffs, message history management, and multi-level hierarchies—so you can focus on defining specialized agents and their supervisor's decision logic. It integrates with LangGraph's streaming, memory, and human-in-the-loop capabilities. However, the library's own documentation now recommends using the supervisor pattern directly via tool-calling for most use cases, suggesting this library is best suited for users upgrading existing code or cases where its abstraction provides clear value.
Use it for
- Route customer support queries to specialized agents (billing, technical, account management) based on intent
- Coordinate research and math agents to answer complex questions requiring both data lookup and calculation
- Build multi-level hierarchies where team supervisors report to a top-level supervisor for large organizations
- Manage conversation history and context across multiple specialized agents in a single workflow
- Add persistent memory and human approval steps to multi-agent workflows via LangGraph checkpointers
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a hierarchical multi-agent system and prefer a structured abstraction over manual tool-calling.
The library is actively maintained, has low install friction, and integrates well with LangGraph's ecosystem. However, review the library's own recommendation to use tool-calling directly for most new projects—install this primarily to upgrade existing code or when the supervisor abstraction clearly simplifies your architecture.
Install
langgraph-supervisor on PyPI
Before you install
Low install friction with only two runtime dependencies (langgraph and langchain-core). Active maintenance with recent releases; last commit 2026-07-15. Requires Python >= 3.10.
Requires Python >= 3.10. Requires langchain-core and langgraph to be installed and configured with a working LLM model.
License in practice
MIT license permits commercial and private use with minimal restrictions, making it suitable for most production deployments.
Quickstart
pip install langgraph-supervisor
from langgraph_supervisor import create_supervisor
from langgraph.prebuilt import create_react_agent
math_agent = create_react_agent(model=model, tools=[add, multiply], name="math_expert")
research_agent = create_react_agent(model=model, tools=[web_search], name="research_expert")
workflow = create_supervisor([research_agent, math_agent], model=model)
app = workflow.compile()
result = app.invoke({"messages": [{"role": "user", "content": "query"}]})Verify before relying
- Whether the library's supervisor pattern remains the recommended approach given the note recommending tool-calling directly for most use cases
- Performance characteristics when managing large numbers of agents or deeply nested hierarchies
- Compatibility guarantees with specific langgraph and langchain-core versions beyond the stated requirements
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packageslanggraphlangchain-core |
| Maintenance | Actively maintained 268 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 718,713 / month, #5,242 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: langgraph_supervisor-0.0.31-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “multi-agent supervisor orchestration”
- langgraph-supervisorBuilds hierarchical multi-agent systems where a supervisor agent…
- cugaCUGA is an enterprise-grade generalist agent framework that…
- autogen-agentchatProvides a high-level API for building multi-agent applications with…
Give your agent the search over MCP, or paste the wish link into any chat.
More Artificial Intelligence packages
LiteLLM provides a unified Python interface to call 100+ LLM providers (OpenAI, Anthropic, Gemini, Bedrock, Azure, and others) using OpenAI-compatible API format, available as both a Python SDK and a self-hosted AI Gateway proxy server.
Install it if you need to work with multiple LLM providers or want to centralize LLM routing in your organization.
Client library and CLI tool for downloading, uploading, and managing models, datasets, and repositories on the Hugging Face Hub platform.
Install it if you work with Hugging Face Hub models or datasets.
LangChain provides a framework for building agents and LLM-powered applications by composing language models, tools, and memory through a unified API that abstracts over multiple model providers.
hf-xet provides chunk-based deduplication and efficient file transfer for the Hugging Face Hub, enabling faster uploads and downloads of large files with local disk caching.
Tokenizers converts raw text into token sequences for NLP models, with support for training custom vocabularies and using pre-built tokenizers (BPE, WordPiece) optimized for speed via Rust.
Transformers provides a unified framework for loading, fine-tuning, and running state-of-the-art pretrained models across text, vision, audio, video, and multimodal tasks using PyTorch, JAX, or TensorFlow.
Install it if you need to run or train any transformer-based model for NLP, vision, audio, or multimodal tasks.
See also langgraph-prebuilt · langgraph-swarm · langmem · agent-framework-orchestrations · langgraph · ag-ui-langgraph · deepagents · supervisord-dependent-startup · agent-governance-toolkit-core · pairmux