Deployment Guide

One-Click Deploy

Click the Deploy button in the project README to open Vercel's import flow. This creates your own deployment with minimal manual setup.

Minimal Environment Variables

Generate secrets with:

openssl rand -base64 32

Setup Flow

The /setup wizard does four things:

1. Connect Supabase with a PAT and project ref
2. Create the first admin account
3. Save model provider keys — at least one model provider API Key and optional embedding credentials
4. Create the first agent and optionally attach an IM platform

If setup shows a security login URL at the end in production, save it immediately.

Local Development

git clone https://github.com/seajelly-dev/seajelly.git
cd seajelly
pnpm install
cp .env.example .env.local
pnpm dev

Open http://localhost:3000, then visit /setup.

Important Notes

• NEXT_PUBLIC_APP_URL must be publicly reachable from Supabase if you use pg_cron, webhook callbacks, previews, or voice temp links.
• For local webhook or scheduled-task testing, use a tunnel such as ngrok or Cloudflare Tunnel instead of localhost.
• If your users are mainly in mainland China, bind a custom domain instead of relying on *.vercel.app.
• The setup flow supports refresh-safe resume in the same browser via a temporary HttpOnly cookie.

Supported Channels

• Telegram
• Feishu
• WeCom
• Slack
• QQ Bot
• WhatsApp

WeCom Integration Note

If you use a WeCom custom app on serverless (Vercel), you will likely also need an Edge Gateway with a fixed public IP to satisfy WeCom IP allowlists.

Supported Model Providers

• Anthropic
• OpenAI
• Google
• DeepSeek
• OpenAI-compatible providers: Groq, OpenRouter, Zhipu AI, Moonshot, MiniMax, DashScope, SiliconFlow, VolcEngine