跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
部署与云服务

langgraph-project-setup

Initialize and configure LangGraph projects with proper structure, langgraph.json configuration, environment variables, and dependency management. Use when users want to (1) create a new LangGraph project, (2) set up langgraph.json for deployment, (3) configure environment variables for LLM providers, (4) initialize project structure for agents, (5) set up local development with LangGraph Studio, (6) configure dependencies (pyproject.toml, requirements.txt, package.json), or (7) troubleshoot project configuration issues.

soba-labs · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add soba-labs/langchain-agent-skills --skill langgraph-project-setup

技能说明


name: langgraph-project-setup description: Initialize and configure LangGraph projects with proper structure, langgraph.json configuration, environment variables, and dependency management. Use when users want to (1) create a new LangGraph project, (2) set up langgraph.json for deployment, (3) configure environment variables for LLM providers, (4) initialize project structure for agents, (5) set up local development with LangGraph Studio, (6) configure dependencies (pyproject.toml, requirements.txt, package.json), or (7) troubleshoot project configuration issues.

LangGraph Project Setup

Initialize and configure LangGraph projects for local development and deployment.

Quick Start

Python Project

# Initialize new project
uv run scripts/init_langgraph_project.py my-agent

# Fallback if uv not available
python3 scripts/init_langgraph_project.py my-agent

# Or with options
uv run scripts/init_langgraph_project.py my-agent \
  --pattern multiagent \
  --python-version 3.12

# Fallback if uv not available
python3 scripts/init_langgraph_project.py my-agent \
  --pattern multiagent \
  --python-version 3.12

JavaScript Project

# Initialize new project
node scripts/init_langgraph_project.js my-agent

# TypeScript project
node scripts/init_langgraph_project.js my-agent --typescript

# Multi-agent pattern
node scripts/init_langgraph_project.js my-agent \
  --pattern multiagent \
  --typescript

Setup Workflow

Step 1: Choose Project Pattern

Simple Pattern: Single agent with straightforward workflow

  • Best for: Getting started, prototypes, single-purpose agents
  • Structure: Minimal files, agent.py/agent.ts at package root

Multi-Agent Pattern: Modular architecture with separated concerns

  • Best for: Complex workflows, multiple agents, production applications
  • Structure: utils/ directory with state.py, nodes.py, tools.py

Step 2: Initialize Project

Run the init script with your chosen pattern:

# Python - simple
uv run scripts/init_langgraph_project.py my-agent

# Fallback if uv not available
python3 scripts/init_langgraph_project.py my-agent

# Python - multi-agent
uv run scripts/init_langgraph_project.py my-agent --pattern multiagent

# Fallback if uv not available
python3 scripts/init_langgraph_project.py my-agent --pattern multiagent

# JavaScript/TypeScript - simple
node scripts/init_langgraph_project.js my-agent --typescript

# JavaScript/TypeScript - multi-agent
node scripts/init_langgraph_project.js my-agent --pattern multiagent --typescript

The script creates:

  • Project directory structure
  • langgraph.json configuration
  • .env template
  • Dependency files (pyproject.toml or package.json)
  • .gitignore
  • Boilerplate code with TODO comments

Step 3: Install Dependencies

Python:

cd my-agent
uv venv --python 3.12
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e '.[dev]'

# Fallback if uv not available
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e '.[dev]'

JavaScript:

cd my-agent
npm install  # or: yarn install / pnpm install

Step 4: Configure Environment Variables

Option A: Interactive Setup (Recommended)

uv run scripts/setup_providers.py

Follow the prompts to configure:

  • OpenAI
  • Anthropic (Claude)
  • Google (Gemini)
  • AWS Bedrock
  • LangSmith (tracing)
  • Tavily (search)

Option B: Manual Configuration

Edit .env file directly:

# Required: Choose at least one LLM provider
OPENAI_API_KEY=sk-...
# or
ANTHROPIC_API_KEY=sk-ant-...

# Optional: Enable tracing
LANGSMITH_API_KEY=lsv2_...
LANGSMITH_TRACING=true
LANGSMITH_PROJECT=my-project

See references/provider-configuration.md for provider-specific setup.

Step 5: Implement Agent Logic

Replace TODO comments in generated files:

Python Simple:

  • Edit my_agent/agent.py
  • Configure LLM in call_model function

Python Multi-Agent:

  • Define state schema in my_agent/utils/state.py
  • Implement node logic in my_agent/utils/nodes.py
  • Add tools in my_agent/utils/tools.py
  • Build graph in my_agent/agent.py

JavaScript/TypeScript:

  • Similar structure in src/ directory
  • Import appropriate LangChain packages

Step 6: Configure langgraph.json

The init script creates a basic configuration. Customize as needed:

{
  "dependencies": ["."],
  "graphs": {
    "agent": "./my_agent/agent.py:graph"
  },
  "env": ".env",
  "python_version": "3.11"
}

Key configuration options:

  • dependencies: Package dependencies location
  • graphs: Mapping of graph IDs to code paths
  • env: Path to environment file
  • python_version or node_version: Runtime version

For complete schema reference, see references/langgraph-json-schema.md.

Step 7: Start Development Server

Option A: langgraph dev (Recommended for development)

langgraph dev
  • No Docker required
  • In-memory state persistence
  • Hot reloading enabled
  • Default port: 2024

Option B: langgraph up (Production-like testing)

langgraph up
  • Docker required
  • PostgreSQL state persistence
  • Production environment simulation
  • Default port: 8123

Step 8: Connect to LangGraph Studio

Access Studio in your browser:

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

Safari users: Use --tunnel flag:

langgraph dev --tunnel

Validation

Validate Configuration

uv run scripts/validate_langgraph_config.py

Checks:

  • Required fields (dependencies, graphs)
  • File paths and references
  • Optional field formats
  • Common configuration errors

Test Agent Locally

# Start server
langgraph dev

# In another terminal, test with curl
curl -X POST http://localhost:2024/invoke \
  -H "Content-Type: application/json" \
  -d '{"input": {"messages": [{"role": "user", "content": "Hello"}]}}'

Common Configurations

Python

阅读完整来源 ↗