langgraph-init-cli 0.1.0__py3-none-any.whl

langgraph_cli/__init__.py

@@ -0,0 +1,5 @@
+"""LangGraph project scaffolding CLI."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

langgraph_cli/cli.py

@@ -0,0 +1,42 @@
+from pathlib import Path
+
+import typer
+
+from langgraph_cli.generator import TEMPLATE_NAMES, scaffold_project
+
+app = typer.Typer(
+    add_completion=False,
+    help="Scaffold LangGraph projects with modular templates.",
+)
+
+
+@app.command()
+def main(
+    project_name: str = typer.Argument(..., help="Directory name for the new project."),
+    template: str = typer.Option(
+        "base",
+        "--template",
+        "-t",
+        help="Project template to use.",
+        case_sensitive=False,
+    ),
+) -> None:
+    normalized = template.lower()
+    if normalized not in TEMPLATE_NAMES:
+        typer.secho(
+            f"Unsupported template '{template}'. Choose from: {', '.join(TEMPLATE_NAMES)}.",
+            fg=typer.colors.RED,
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    target_path = Path(project_name).resolve()
+    scaffold_project(project_name=project_name, template_name=normalized, target_dir=target_path)
+    typer.secho(
+        f"Created {normalized} LangGraph project at {target_path}",
+        fg=typer.colors.GREEN,
+    )
+
+
+if __name__ == "__main__":
+    app()

langgraph_cli/generator.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+import shutil
+from importlib import resources
+from pathlib import Path
+
+TEMPLATE_NAMES = ("base", "advanced", "production")
+TOKEN_MAP_KEY = "{{PROJECT_NAME}}"
+
+
+def _template_root() -> Path:
+    return Path(str(resources.files("langgraph_cli").joinpath("templates")))
+
+
+def _replace_tokens(content: str, project_name: str) -> str:
+    return content.replace(TOKEN_MAP_KEY, project_name)
+
+
+def scaffold_project(project_name: str, template_name: str, target_dir: Path) -> Path:
+    source_dir = _template_root() / template_name
+    if not source_dir.exists():
+        raise FileNotFoundError(f"Template '{template_name}' does not exist.")
+
+    if target_dir.exists() and any(target_dir.iterdir()):
+        raise FileExistsError(f"Target directory '{target_dir}' already exists and is not empty.")
+
+    target_dir.mkdir(parents=True, exist_ok=True)
+
+    for source_path in source_dir.rglob("*"):
+        if "__pycache__" in source_path.parts or source_path.suffix == ".pyc":
+            continue
+        relative_path = source_path.relative_to(source_dir)
+        destination = target_dir / relative_path
+
+        if source_path.is_dir():
+            destination.mkdir(parents=True, exist_ok=True)
+            continue
+
+        destination.parent.mkdir(parents=True, exist_ok=True)
+        if source_path.suffix in {".png", ".jpg", ".jpeg", ".gif", ".ico"}:
+            shutil.copy2(source_path, destination)
+            continue
+
+        rendered = _replace_tokens(source_path.read_text(encoding="utf-8"), project_name=project_name)
+        destination.write_text(rendered, encoding="utf-8")
+
+    return target_dir

langgraph_cli/templates/advanced/README.md

@@ -0,0 +1,3 @@
+# {{PROJECT_NAME}}
+
+Advanced LangGraph scaffold generated by `langgraph-init`.

langgraph_cli/templates/advanced/langgraph.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": ["."],
+  "graphs": {
+    "{{PROJECT_NAME}}": "src.app.main:run"
+  }
+}

langgraph_cli/templates/advanced/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{PROJECT_NAME}}"
+version = "0.1.0"
+description = "Advanced LangGraph scaffold for {{PROJECT_NAME}}"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "langgraph>=0.2.0",
+  "langchain>=0.3.0",
+  "langsmith>=0.1.0",
+  "python-dotenv>=1.0.0",
+  "typer>=0.12.0",
+]
+
+[tool.setuptools.packages.find]
+include = ["src*"]

langgraph_cli/templates/advanced/src/__init__.py

@@ -0,0 +1 @@
+"""Project source package."""

langgraph_cli/templates/advanced/src/app/__init__.py

@@ -0,0 +1 @@
+"""Advanced app package."""

langgraph_cli/templates/advanced/src/app/graph/__init__.py

@@ -0,0 +1 @@
+"""Graph package."""

langgraph_cli/templates/advanced/src/app/graph/builder.py

@@ -0,0 +1,18 @@
+from langgraph.graph import END, START, StateGraph
+
+from src.app.graph.constants import Names
+from src.app.graph.edges import EDGE_MAP, route_after_process
+from src.app.graph.registry import NODE_REGISTRY
+from src.app.graph.state import WorkflowState
+
+
+def build_graph():
+    graph = StateGraph(WorkflowState)
+    for name, node in NODE_REGISTRY.items():
+        graph.add_node(name, node)
+
+    graph.add_edge(START, Names.INTENT)
+    graph.add_edge(Names.INTENT, Names.PROCESS)
+    graph.add_conditional_edges(Names.PROCESS, route_after_process, EDGE_MAP)
+    graph.add_edge(Names.OUTPUT, END)
+    return graph.compile()

langgraph_cli/templates/advanced/src/app/graph/constants.py

@@ -0,0 +1,20 @@
+from src.app.nodes.intent import intent_node
+from src.app.nodes.output import output_node
+from src.app.nodes.processing import processing_node
+
+
+class Names:
+    INTENT = "intent"
+    PROCESS = "process"
+    OUTPUT = "output"
+
+
+class Tags:
+    CONTINUE = "continue"
+    COMPLETE = "complete"
+
+
+class Nodes:
+    INTENT = intent_node
+    PROCESS = processing_node
+    OUTPUT = output_node

langgraph_cli/templates/advanced/src/app/graph/edges.py

@@ -0,0 +1,14 @@
+from src.app.graph.constants import Names, Tags
+from src.app.graph.state import WorkflowState
+
+
+def route_after_process(state: WorkflowState) -> str:
+    if state.get("validation_passed"):
+        return Tags.COMPLETE
+    return Tags.CONTINUE
+
+
+EDGE_MAP = {
+    Tags.COMPLETE: Names.OUTPUT,
+    Tags.CONTINUE: Names.PROCESS,
+}

langgraph_cli/templates/advanced/src/app/graph/registry.py

@@ -0,0 +1,8 @@
+from src.app.graph.constants import Names, Nodes
+
+
+NODE_REGISTRY = {
+    Names.INTENT: Nodes.INTENT,
+    Names.PROCESS: Nodes.PROCESS,
+    Names.OUTPUT: Nodes.OUTPUT,
+}

langgraph_cli/templates/advanced/src/app/graph/state.py

@@ -0,0 +1,9 @@
+from typing import TypedDict
+
+
+class WorkflowState(TypedDict, total=False):
+    input_text: str
+    intent: str
+    extracted_value: str
+    output: str
+    validation_passed: bool

langgraph_cli/templates/advanced/src/app/main.py

@@ -0,0 +1,12 @@
+from src.app.graph.builder import build_graph
+
+
+def run():
+    app = build_graph()
+    result = app.invoke({"input_text": "Calculate 2 + 2 and confirm it is valid."})
+    print(result["output"])
+    return result
+
+
+if __name__ == "__main__":
+    run()

langgraph_cli/templates/advanced/src/app/nodes/__init__.py

@@ -0,0 +1 @@
+"""Nodes package."""

langgraph_cli/templates/advanced/src/app/nodes/intent.py

@@ -0,0 +1,9 @@
+from src.app.graph.state import WorkflowState
+
+
+def intent_node(state: WorkflowState) -> WorkflowState:
+    text = state.get("input_text", "").lower()
+    intent = "answer"
+    if any(token in text for token in ("calculate", "+", "-", "*", "/")):
+        intent = "math"
+    return {"intent": intent}

langgraph_cli/templates/advanced/src/app/nodes/output.py

@@ -0,0 +1,10 @@
+from src.app.graph.state import WorkflowState
+
+
+def output_node(state: WorkflowState) -> WorkflowState:
+    return {
+        "output": (
+            f"Intent={state.get('intent', 'unknown')}; "
+            f"Extracted={state.get('extracted_value', 'none')}"
+        )
+    }

langgraph_cli/templates/advanced/src/app/nodes/processing.py

@@ -0,0 +1,14 @@
+import re
+
+from src.app.graph.state import WorkflowState
+from src.app.prompts.registry import PromptRegistry
+from src.app.services.prompt_service import PromptService
+
+
+def processing_node(state: WorkflowState) -> WorkflowState:
+    prompt = PromptService(PromptRegistry()).get_prompt("processing")
+    text = state.get("input_text", "")
+    numbers = re.findall(r"\d+", text)
+    extracted = ", ".join(numbers) if numbers else prompt
+    validation_passed = bool(extracted)
+    return {"extracted_value": extracted, "validation_passed": validation_passed}

langgraph_cli/templates/advanced/src/app/prompts/__init__.py

@@ -0,0 +1 @@
+"""Prompts package."""

langgraph_cli/templates/advanced/src/app/prompts/registry.py

@@ -0,0 +1,12 @@
+class PromptRegistry:
+    def __init__(self) -> None:
+        self._prompts = {
+            "processing": {
+                "v1": "Extract relevant entities from the request.",
+            }
+        }
+        self._defaults = {"processing": "v1"}
+
+    def get(self, task: str, version: str | None = None) -> str:
+        selected_version = version or self._defaults[task]
+        return self._prompts[task][selected_version]

langgraph_cli/templates/advanced/src/app/services/__init__.py

@@ -0,0 +1 @@
+"""Services package."""

langgraph_cli/templates/advanced/src/app/services/prompt_service.py

@@ -0,0 +1,6 @@
+class PromptService:
+    def __init__(self, registry):
+        self.registry = registry
+
+    def get_prompt(self, task: str, version: str | None = None) -> str:
+        return self.registry.get(task, version=version)

langgraph_cli/templates/advanced/src/app/utils/__init__.py

@@ -0,0 +1 @@
+"""Utility package."""

langgraph_cli/templates/advanced/src/app/utils/logger.py

@@ -0,0 +1,6 @@
+import logging
+
+
+def get_logger(name: str) -> logging.Logger:
+    logging.basicConfig(level=logging.INFO, format="%(levelname)s %(name)s %(message)s")
+    return logging.getLogger(name)

langgraph_cli/templates/base/README.md

@@ -0,0 +1,3 @@
+# {{PROJECT_NAME}}
+
+Base LangGraph scaffold generated by `langgraph-init`.

langgraph_cli/templates/base/langgraph.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": ["."],
+  "graphs": {
+    "{{PROJECT_NAME}}": "src.app.main:run"
+  }
+}

langgraph_cli/templates/base/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{PROJECT_NAME}}"
+version = "0.1.0"
+description = "Base LangGraph scaffold for {{PROJECT_NAME}}"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "langgraph>=0.2.0",
+  "langchain>=0.3.0",
+  "langsmith>=0.1.0",
+  "python-dotenv>=1.0.0",
+  "typer>=0.12.0",
+]
+
+[tool.setuptools.packages.find]
+include = ["src*"]

langgraph_cli/templates/base/src/__init__.py

@@ -0,0 +1 @@
+"""Project source package."""

langgraph_cli/templates/base/src/app/__init__.py

@@ -0,0 +1 @@
+"""Base app package."""

langgraph_cli/templates/base/src/app/main.py

@@ -0,0 +1,27 @@
+from langgraph.graph import END, START, StateGraph
+
+from src.app.nodes import draft_node, intake_node, output_node
+from src.app.state import AppState
+
+
+def build_graph():
+    graph = StateGraph(AppState)
+    graph.add_node("intake", intake_node)
+    graph.add_node("draft", draft_node)
+    graph.add_node("output", output_node)
+    graph.add_edge(START, "intake")
+    graph.add_edge("intake", "draft")
+    graph.add_edge("draft", "output")
+    graph.add_edge("output", END)
+    return graph.compile()
+
+
+def run() -> AppState:
+    app = build_graph()
+    result = app.invoke({"user_input": "Support request for order status"})
+    print(result["response"])
+    return result
+
+
+if __name__ == "__main__":
+    run()

langgraph_cli/templates/base/src/app/nodes.py

@@ -0,0 +1,22 @@
+from src.app.state import AppState
+
+
+def intake_node(state: AppState) -> AppState:
+    text = state.get("user_input", "").strip()
+    topic = "general"
+    lowered = text.lower()
+    if "billing" in lowered:
+        topic = "billing"
+    elif "support" in lowered:
+        topic = "support"
+    return {"topic": topic}
+
+
+def draft_node(state: AppState) -> AppState:
+    topic = state.get("topic", "general")
+    text = state.get("user_input", "")
+    return {"response": f"[{topic}] {text}"}
+
+
+def output_node(state: AppState) -> AppState:
+    return {"response": state.get("response", "No response generated.")}

langgraph_cli/templates/base/src/app/state.py

@@ -0,0 +1,7 @@
+from typing import TypedDict
+
+
+class AppState(TypedDict, total=False):
+    user_input: str
+    topic: str
+    response: str

langgraph_cli/templates/production/README.md

@@ -0,0 +1,121 @@
+# {{PROJECT_NAME}}
+
+Production-grade LangGraph scaffold generated by `langgraph-init`.
+
+## Overview
+
+This project is a modular LangGraph application designed to serve as a strong starting point for agentic workflows in production-style environments. It includes graph orchestration, node isolation, service boundaries, prompt versioning, evaluation, structured logging, LangSmith integration hooks, and an extensible tool system.
+
+## Project Layout
+
+```text
+src/app/
+├── main.py
+├── config.py
+├── graph/
+├── nodes/
+├── services/
+├── tools/
+├── prompts/
+├── models/
+├── storage/
+├── utils/
+├── observability/
+├── evaluation/
+└── api/
+```
+
+## Quick Start
+
+Install dependencies:
+
+```bash
+pip install -e .
+```
+
+Run the sample workflow:
+
+```bash
+python -m src.app.main
+```
+
+## How It Works
+
+The application compiles a `StateGraph` in `src/app/graph/builder.py`.
+
+Execution flow:
+
+1. `intent` classifies the request
+2. `processing` extracts structured data and calls tools
+3. `validation` scores the extraction
+4. `output` returns the final response when validation passes
+5. `error` returns a failure response when retries are exhausted
+
+Validation uses conditional routing, so unsuccessful validation can retry processing before terminating.
+
+## Graph Conventions
+
+The graph layer uses three abstractions:
+
+- `Names`: stable node names used when building the graph
+- `Nodes`: callable implementations
+- `Tags`: conditional routing labels
+
+This keeps graph orchestration readable and easy to extend.
+
+## Prompts
+
+Prompt files live in `src/app/prompts/versions/` and are loaded by task/version.
+
+Features:
+
+- Default version selection from config
+- Version-specific lookup
+- Fallback to `v1`
+- Prompt access tracking
+
+## Tools
+
+The scaffold includes a built-in registry and several deterministic tools:
+
+- `calculator`
+- `query`
+- `http`
+- `retriever`
+
+Add new tools by implementing `BaseTool` and registering them in `src/app/tools/registry.py`.
+
+## Evaluation
+
+The evaluation layer currently measures:
+
+- Field coverage
+- Confidence score
+- Validation pass/fail
+
+This makes it easy to swap in richer metrics later.
+
+## Observability
+
+Observability support includes:
+
+- Structured JSON logging
+- Basic metrics counters
+- LangSmith environment wiring
+- Trace decorators for service methods
+
+To enable LangSmith tracing, copy `.env.example` to `.env` and set the required values.
+
+## API Surface
+
+A lightweight API-facing wrapper is included under `src/app/api/` so the graph can be invoked through another interface later without changing the core graph design.
+
+## Next Steps
+
+Recommended follow-up work:
+
+- Connect a real LLM provider
+- Add persistent storage backends
+- Add domain-specific tools
+- Add tests for graph transitions and service behavior
+- Expand prompt sets and versions

langgraph_cli/templates/production/langgraph.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": ["."],
+  "graphs": {
+    "{{PROJECT_NAME}}": "src.app.main:run"
+  }
+}

langgraph_cli/templates/production/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "{{PROJECT_NAME}}"
+version = "0.1.0"
+description = "Production LangGraph scaffold for {{PROJECT_NAME}}"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+  "langgraph>=0.2.0",
+  "langchain>=0.3.0",
+  "langsmith>=0.1.0",
+  "python-dotenv>=1.0.0",
+  "typer>=0.12.0",
+]
+
+[tool.setuptools.packages.find]
+include = ["src*"]

langgraph_cli/templates/production/src/__init__.py

@@ -0,0 +1 @@
+"""Project source package."""

langgraph_cli/templates/production/src/app/__init__.py

@@ -0,0 +1 @@
+"""Production app package."""

langgraph_cli/templates/production/src/app/api/__init__.py

@@ -0,0 +1 @@
+"""API package."""