mirror of
https://github.com/Sea-Haven-Industries/open-swe.git
synced 2026-09-30 15:03:16 +00:00
125 lines
4.3 KiB
Text
125 lines
4.3 KiB
Text
---
|
|
title: 'Quick Start'
|
|
description: 'Follow these steps to get your Open Agent Platform up and running quickly.'
|
|
---
|
|
|
|
<Info>
|
|
**Prerequisites:**
|
|
- Clone the [Open Agent Platform Repository](https://github.com/langchain-ai/open-agent-platform)
|
|
- [LangSmith](https://smith.langchain.com/) Account (free tier is sufficient)
|
|
- [Supabase](https://supabase.com/) Account
|
|
- MCP Server (e.g. [Arcade](https://arcade-ai.com/))
|
|
- An LLM API Key (e.g. [OpenAI](https://platform.openai.com/), [Anthropic](https://console.anthropic.com/), [Google](https://aistudio.google.com/))
|
|
</Info>
|
|
|
|
## 1. Authentication Setup
|
|
|
|
Open Agent Platform uses Supabase for authentication by default.
|
|
|
|
<Steps>
|
|
<Step title="Create a Supabase Project">
|
|
Create a new project in [Supabase](https://supabase.com/).
|
|
</Step>
|
|
<Step title="Configure Environment Variables">
|
|
Set the following environment variables inside the `apps/web/` directory:
|
|
```bash
|
|
NEXT_PUBLIC_SUPABASE_URL="<your supabase url>"
|
|
NEXT_PUBLIC_SUPABASE_ANON_KEY="<your supabase anon key>"
|
|
```
|
|
</Step>
|
|
<Step title="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.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## 2. Deploying Agents
|
|
|
|
The next step in setting up Open Agent Platform is to deploy and configure your agents.
|
|
|
|
<Steps>
|
|
<Step title="Clone Pre-built Agents">
|
|
We've released two pre-built agents specifically for Open Agent Platform:
|
|
- [Tools Agent](https://github.com/langchain-ai/oap-langgraph-tools-agent)
|
|
- [Supervisor Agent](https://github.com/langchain-ai/oap-agent-supervisor)
|
|
</Step>
|
|
<Step title="Follow Agent Setup Instructions">
|
|
For each agent repository:
|
|
1. Clone the repository
|
|
2. Follow the instructions in the README
|
|
3. Deploy the agents to LangGraph Platform
|
|
</Step>
|
|
<Step title="Configure Environment Variables">
|
|
After deployment, create a configuration object for each agent:
|
|
```json
|
|
{
|
|
"id": "The project ID of the deployment",
|
|
"tenantId": "The tenant ID of your LangSmith account",
|
|
"deploymentUrl": "The API URL to your deployment",
|
|
"name": "A custom name for your deployment",
|
|
"isDefault": "Whether this deployment is the default deployment (only one can be default)",
|
|
"defaultGraphId": "The graph ID of the default graph (optional, only required if isDefault is true)"
|
|
}
|
|
```
|
|
|
|
You can find your project & tenant IDs with a GET request to the `/info` endpoint on your LangGraph Platform deployment.
|
|
</Step>
|
|
<Step title="Set Environment Variables">
|
|
Combine your agent configurations into a JSON array and set the `NEXT_PUBLIC_DEPLOYMENTS` environment variable inside the `apps/web/` directory:
|
|
|
|
```bash
|
|
NEXT_PUBLIC_DEPLOYMENTS=[{"id":"bf63dc89-1de7-4a65-8336-af9ecda479d6","deploymentUrl":"http://localhost:2024","tenantId":"42d732b3-1324-4226-9fe9-513044dceb58","name":"Local deployment","isDefault":true,"defaultGraphId":"agent"}]
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
## 3. RAG Server Setup
|
|
|
|
<Steps>
|
|
<Step title="Deploy LangConnect">
|
|
Follow the instructions in the [LangConnect README](https://github.com/langchain-ai/langconnect) to set up and deploy a LangConnect RAG server.
|
|
</Step>
|
|
<Step title="Configure Environment Variables">
|
|
Set the RAG server URL inside the `apps/web/` directory:
|
|
```bash
|
|
NEXT_PUBLIC_RAG_API_URL="http://localhost:8080"
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
## 4. MCP Server Setup
|
|
|
|
<Tip>
|
|
Open Agent Platform only supports connecting to MCP servers which support Streamable HTTP requests.
|
|
</Tip>
|
|
|
|
<Steps>
|
|
<Step title="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):
|
|
```bash
|
|
NEXT_PUBLIC_MCP_SERVER_URL="<your MCP server URL>"
|
|
```
|
|
</Step>
|
|
<Step title="Configure Authentication (if required)">
|
|
For authenticated MCP servers:
|
|
```bash
|
|
NEXT_PUBLIC_MCP_AUTH_REQUIRED=true
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
## 5. Run Your Platform
|
|
|
|
Start the application with your configured environment variables:
|
|
|
|
```bash
|
|
# Navigate to the web app directory
|
|
cd apps/web
|
|
|
|
# Install dependencies
|
|
yarn install
|
|
|
|
# Start the development server
|
|
yarn dev
|
|
```
|
|
|
|
Your Open Agent Platform should now be running at http://localhost:3000!
|