Create a new LangGraph project
The official scaffolding tool for LangGraph.js projects. Quickly bootstrap new LangGraph applications from curated templates or generate configuration files for existing projects.
Create a new LangGraph project with a single command:
``bashUsing npm
npm init langgraph@latest
Follow the interactive prompts to select a template and configure your project.
Templates
Choose from a variety of production-ready templates:
| Template | Description |
| ------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| New LangGraph Project | A simple, minimal chatbot with memory |
| ReAct Agent | A flexible agent that can be extended with many tools |
| Memory Agent | A ReAct-style agent with persistent memory across conversations |
| Retrieval Agent | An agent with retrieval-based question-answering |
| Data-enrichment Agent | An agent that performs web searches and organizes findings |
$3
Skip the interactive prompt by specifying a template directly:
bash
npx create-langgraph@latest my-project --template react-agent-js
`Available template IDs:
-
-
-
-
- Commands
$3
Creates a new LangGraph project at the specified path.
bash
npx create-langgraph@latest my-awesome-agent
`Options:
-
— Use a specific template (skips interactive selection)What it does:
1. Downloads the selected template from GitHub
2. Extracts it to your target directory
3. Optionally initializes a Git repository
4. Provides next steps for getting started
$3
Scans your project for LangGraph agents and generates a
langgraph.json configuration file.`bash
In your project directory
npx create-langgraph@latest configOr specify a path
npx create-langgraph@latest config ./my-project
`This command is useful when:
- You have an existing project and want to add LangGraph Platform support
- You've added new agents and need to update your configuration
- You want to automatically detect all agents in your codebase
Agent Detection
The
command automatically detects LangGraph agents defined using these patterns:$3
`typescript
// Using createAgent
export const agent = createAgent({ model, tools });// Using StateGraph
export const graph = new StateGraph(annotation).compile();
// Using workflow builder pattern
export const app = workflow.compile();
`$3
javascript
// Using module.exports
module.exports.agent = createAgent({ model, tools });
module.exports.graph = workflow.compile();// Using exports shorthand
exports.myAgent = createAgent({ model, tools });
`$3
The scanner looks for:
-
function calls
- new StateGraph(...).compile() patterns
- workflow.compile() or builder.compile() patternsImportant: Only exported agents are included in the generated configuration. Unexported agents will be listed as warnings so you can add the
export keyword if needed.Generated Configuration
The
config command generates a langgraph.json file like this:`json
{
"node_version": "20",
"graphs": {
"agent": "./src/agent.ts:agent",
"searchAgent": "./src/search.ts:searchAgent"
},
"env": ".env"
}
`The configuration includes:
- node_version — Detected from your current Node.js version
- graphs — Map of agent names to their file paths and export names
- env — Path to
file (if one exists)Project Structure
After scaffolding, your project will have this structure:
`txt
my-project/
├── src/
│ └── agent.ts # Your LangGraph agent
├── langgraph.json # LangGraph configuration
├── package.json
├── tsconfig.json
└── .env.example # Environment variables template
`Next Steps After Creating a Project
bash
Navigate to your project
cd my-projectInstall dependencies
npm install # or yarn, pnpm, bunStart the LangGraph development server
npx @langchain/langgraph-cli@latest dev
`The development server provides:
- A local API server for your agents
- Hot reloading during development
- Built-in debugging tools
Analytics
This CLI collects anonymous usage analytics to help improve the tool. The following information is collected:
- Operating system and version
- Node.js version
- CLI version
- Command executed
No personal information, project details, or code is ever collected.
To opt out of analytics, set the environment variable:
bash
export LANGGRAPH_CLI_NO_ANALYTICS=1
``- Node.js 18 or later
- npm, yarn, pnpm, or bun
- @langchain/langgraph — The core LangGraph library
- @langchain/langgraph-cli — CLI tools for running LangGraph projects
MIT © LangChain