This is a starter template for building AI agents using LangGraph and CopilotKit. It provides a modern Next.js application with an integrated LangGraph agent to be built on top of.
This project is organized as a monorepo using Turborepo and pnpm workspaces.
.
├── apps/
│ ├── web/ # Next.js frontend application
│ └── agent/ # LangGraph agent
├── pnpm-workspace.yaml
├── turbo.json
└── package.json
- Node.js 18+
- pnpm 9.15.0 or later
- OpenAI API Key (for the LangGraph agent)
- Install all dependencies (this installs everything for both apps):
pnpm install- Set up your OpenAI API key:
cd apps/agent
echo "OPENAI_API_KEY=your-openai-api-key-here" > .env- Start the development servers:
pnpm devThis will start both the Next.js app (on port 3000) and the LangGraph agent (on port 8123) using Turborepo.
All scripts use Turborepo to run tasks across the monorepo:
pnpm dev- Starts both the web app and agent servers in development modepnpm dev:studio- Starts the web app and agent with LangGraph Studio UIpnpm build- Builds all apps for productionpnpm lint- Runs linting across all apps
You can also run scripts for individual apps using pnpm's filter flag:
# Run dev for just the web app
pnpm --filter web dev
# Run dev for just the agent
pnpm --filter agent dev
# Or navigate to the app directory
cd apps/web
pnpm devThe main UI component is in apps/web/src/app/page.tsx. You can:
- Modify the theme colors and styling
- Add new frontend actions
- Utilize shared-state
- Customize your user-interface for interacting with LangGraph
The LangGraph agent code is in apps/agent/src/.
- CopilotKit Documentation - Explore CopilotKit's capabilities
- LangGraph Documentation - Learn more about LangGraph and its features
- Next.js Documentation - Learn about Next.js features and API
Feel free to submit issues and enhancement requests! This starter is designed to be easily extensible.
This project is licensed under the MIT License - see the LICENSE file for details.
If you see "I'm having trouble connecting to my tools", make sure:
- The LangGraph agent is running on port 8000
- Your OpenAI API key is set correctly
- Both servers started successfully