Getting Started

Set Up Environment Variables:

Create a .env file in the root directory and add your LangSmith and OpenAI API keys:

LANGSMITH_API_KEY=lsv2_...
OPENAI_API_KEY=sk-...

Then, create another .env file inside the agent directory:

OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=lsv2_...

Set Up Poetry:

Poetry manages agent service dependencies. Install it using:

pip install poetry

Verify installation with:

poetry --version

Development

For debugging, run the frontend and agent separately:

# Terminal 1 - Frontend
pnpm run dev-frontend

# Terminal 2 - Agent
pnpm run dev-agent

Alternatively, run both with:

pnpm run dev

Access the application at http://localhost:3000.

Architecture

The project consists of:

1. /agent folder: A LangGraph agent that interacts with MCP servers by calling their tools.
2. /app folder: A frontend application built with CopilotKit for UI and state management.