Quick Start
Follow these steps to get your Open Agent Platform up and running quickly.
1. Authentication Setup
Open Agent Platform uses Supabase for authentication by default.
Create a Supabase Project
Create a new project in Supabase.
Configure Environment Variables
Set the following environment variables inside the apps/web/
directory:
Enable Authentication Providers
Enable Google authentication in your Supabase project, or set NEXT_PUBLIC_GOOGLE_AUTH_DISABLED=true
in your environment variables to disable showing Google as an authentication option in the UI.
2. Deploying Agents
The next step in setting up Open Agent Platform is to deploy and configure your agents.
Clone Pre-built Agents
We’ve released two pre-built agents specifically for Open Agent Platform:
Follow Agent Setup Instructions
For each agent repository:
- Clone the repository
- Follow the instructions in the README
- Deploy the agents to LangGraph Platform, or run
langgraph dev
to run the agents locally. Optionally pass--port <port>
to use a custom port. This is useful if running multiple graphs locally.
Configure Environment Variables
After deployment, create a configuration object for each agent:
You can find your project & tenant IDs with a GET request to the /info
endpoint on your LangGraph Platform deployment.
If you are running agents locally via langgraph dev
, the id
(project ID), and tenantId
should be any valid UUID version 4, such as those generated by uuid.uuid4()
. Ensure each graph has a unique id
, and all graphs share the same tenantId
.
Set Environment Variables
Combine your agent configurations into a JSON array and set the NEXT_PUBLIC_DEPLOYMENTS
environment variable inside the apps/web/
directory:
3. RAG Server Setup
Deploy LangConnect
Follow the instructions in the LangConnect README to set up and deploy a LangConnect RAG server.
Configure Environment Variables
Set the RAG server URL inside the apps/web/
directory:
4. MCP Server Setup
Open Agent Platform only supports connecting to MCP servers which support Streamable HTTP requests.
Configure MCP Server URL
Set your MCP server URL inside the apps/web/
directory (ensure it does not end with /mcp
. This will be auto-applied by OAP):
Configure Authentication (if required)
For authenticated MCP servers:
5. Run Your Platform
Start the application with your configured environment variables:
Your Open Agent Platform should now be running at http://localhost:3000!