lg:create

lg:create - LangGraph Project Creator

Create production-ready LangGraph projects with best practices built-in.

Workflow Steps

1. Validate Input

   • Check project name validity
   • Verify output path exists
   • Validate flag combinations

2. Generate Project Structure

   • Create directory structure based on type
   • Generate pyproject.toml with dependencies
   • Create .env.example file
   • Setup configuration files

3. Generate Core Components

   • Create state schema
   • Generate graph definition
   • Implement chosen pattern
   • Add memory/checkpoint system

4. Add Integrations

   • Setup LLM provider configuration
   • Add tool definitions
   • Configure streaming (if enabled)
   • Setup LangSmith tracing (if enabled)

5. Generate Wrappers

   • Create CLI wrapper (if --cli)
   • Create MCP server wrapper (if --mcp)
   • Add FastAPI server (optional)

6. Create Tests

   • Generate test files
   • Add example test cases
   • Create test fixtures

7. Generate Documentation

   • Create README.md
   • Add architecture diagram
   • Document API/CLI usage
   • Add deployment guide

8. Setup Development Environment

   • Create virtual environment
   • Install dependencies
   • Run initial tests
   • Verify graph structure

Architecture Patterns

ReAct Pattern

# Reasoning and Acting loop
graph = StateGraph(AgentState)
graph.add_node("agent", agent_node)
graph.add_node("tools", tool_node)
graph.add_edge(START, "agent")
graph.add_conditional_edges("agent", should_continue)
graph.add_edge("tools", "agent")

Supervisor Pattern

# Supervisor delegates to workers
graph = StateGraph(State)
graph.add_node("supervisor", supervisor_node)
graph.add_node("worker_1", worker_1_node)
graph.add_node("worker_2", worker_2_node)
graph.add_conditional_edges("supervisor", route_to_worker)

Swarm Pattern

# Autonomous agents collaborate
graph = StateGraph(SwarmState)
for agent in agents:
    graph.add_node(agent.name, agent.node)
    graph.add_edge(agent.name, "coordinator")
graph.add_conditional_edges("coordinator", route_next)