快速入门：本地启动 LangGraph 服务器

本指南将帮助您在本地快速启动并运行 LangGraph 应用。

环境要求

Python >= 3.11
LangGraph CLI：需要 langchain-cli[inmem] >= 0.1.58

安装 LangGraph CLI

bash
pip install --upgrade "langgraph-cli[inmem]"

创建 LangGraph 应用

使用 react-agent 模板创建一个新应用。该模板是一个简单的代理，可以灵活扩展以支持多种工具。

bash
langgraph new path/to/your/app --template react-agent-python

其他模板
如果不指定模板，langgraph new 会显示交互式菜单，供您选择可用模板。

安装依赖

在应用根目录下，以编辑模式安装依赖，以便服务器使用本地更改：

bash
pip install -e .

创建 `.env` 文件

在应用根目录下找到 .env.example 文件，创建 .env 文件并复制内容，填写必要的 API 密钥：

env
LANGSMITH_API_KEY=lsv2...
TAVILY_API_KEY=tvly-...
ANTHROPIC_API_KEY=sk-
OPENAI_API_KEY=sk-...

启动 LangGraph 服务器

bash
langgraph dev

如果成功启动，您将看到类似以下输出：


Ready!

API: http://localhost:2024

Docs: http://localhost:2024/docs

LangGraph Studio Web UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024

内存模式
langgraph dev 以内存模式启动服务器，适合开发和测试。生产环境应使用持久化存储后端。

持久化模式
使用 langgraph up 命令启动持久化模式（需要 Docker）。

LangGraph Studio Web UI

LangGraph Studio Web 是一个专用 UI，可连接到 LangGraph API 服务器，支持可视化、交互和调试。

访问 langgraph dev 输出中的 URL 即可使用。

自定义主机/端口
如果服务器使用自定义主机/端口，可以通过修改 baseUrl 参数指向服务器。例如，端口为 8000 时：


https://smith.langchain.com/studio/baseUrl=http://127.0.0.1:8000

Safari 兼容性
目前，LangGraph Studio Web 不支持 Safari。

测试 API

安装 Python SDK

bash
pip install langgraph-sdk

发送消息（无线程运行）

python
from langgraph_sdk import get_client

client = get_client(url="http://localhost:2024")

async for chunk in client.runs.stream(
    None,  # 无线程运行
    "agent", # 代理名称（在 langgraph.json 中定义）
    input={
        "messages": [{
            "role": "human",
            "content": "What is LangGraph?",
        }],
    },
    stream_mode="updates",
):
    print(f"Receiving new event of type: {chunk.event}...")
    print(chunk.data)
    print("\n\n")

认证
连接远程服务器时，需要提供 LangSmith API 密钥。详见客户端 API 参考。

下一步

现在您已成功在本地运行 LangGraph 应用，接下来可以探索部署和高级功能：

🌐 部署到 LangGraph Cloud
使用 LangGraph Cloud 快速部署您的应用。
📚 学习 LangGraph 平台
通过以下资源扩展知识：
- LangGraph 平台概念
- LangGraph 平台操作指南
🛠️ 开发者参考
访问详细文档：

开始构建您的智能系统吧！🚀

目录