Agent Chat UI

Agent Chat UI is a Vite + React application which enables chatting with any LangGraph server with a messages key through a chat interface.

Note

🎥 Watch the video setup guide here.

Setup

Tip

Don't want to run the app locally? Use the deployed site here: agentchat.vercel.app!

First, clone the repository, or run the npx command:

npx create-agent-chat-app

or

git clone https://github.com/langchain-ai/agent-chat-ui.git

cd agent-chat-ui

Install dependencies:

pnpm install

Run the app:

pnpm dev

The app will be available at http://localhost:5173.

Usage

Once the app is running (or if using the deployed site), you'll be prompted to enter:

• Deployment URL: The URL of the LangGraph server you want to chat with. This can be a production or development URL.
• Assistant/Graph ID: The name of the graph, or ID of the assistant to use when fetching, and submitting runs via the chat interface.
• LangSmith API Key: (only required for connecting to deployed LangGraph servers) Your LangSmith API key to use when authenticating requests sent to LangGraph servers.

After entering these values, click Continue. You'll then be redirected to a chat interface where you can start chatting with your LangGraph server.

Environment Variables

You can bypass the initial setup form by setting the following environment variables:

VITE_API_URL=http://localhost:2024
VITE_ASSISTANT_ID=agent
VITE_LANGSMITH_API_KEY=your_api_key_if_needed

To use these variables:

1. Copy the .env.example file to a new file named .env
2. Fill in the values in the .env file
3. Restart the application

When these environment variables are set, the application will use them instead of showing the setup form.