feat: add multica/
This commit is contained in:
Sun-ZhenXing
@@ -0,0 +1,55 @@
|
||||
# Source build configuration
|
||||
MULTICA_VERSION=v0.1.32
|
||||
MULTICA_PGVECTOR_VERSION=pg17
|
||||
|
||||
# Ports
|
||||
MULTICA_BACKEND_PORT_OVERRIDE=8080
|
||||
MULTICA_FRONTEND_PORT_OVERRIDE=3000
|
||||
|
||||
# PostgreSQL
|
||||
MULTICA_POSTGRES_DB=multica
|
||||
MULTICA_POSTGRES_USER=multica
|
||||
MULTICA_POSTGRES_PASSWORD=multica
|
||||
|
||||
# Authentication & Security (CHANGEME: update JWT_SECRET for production)
|
||||
MULTICA_JWT_SECRET=change-me-in-production
|
||||
|
||||
# Frontend origin (used by backend for CORS and cookie settings)
|
||||
MULTICA_FRONTEND_ORIGIN=http://localhost:3000
|
||||
MULTICA_APP_URL=http://localhost:3000
|
||||
MULTICA_CORS_ALLOWED_ORIGINS=
|
||||
MULTICA_COOKIE_DOMAIN=
|
||||
|
||||
# Email via Resend (optional)
|
||||
MULTICA_RESEND_API_KEY=
|
||||
MULTICA_RESEND_FROM_EMAIL=noreply@multica.ai
|
||||
|
||||
# Google OAuth (optional)
|
||||
MULTICA_GOOGLE_CLIENT_ID=
|
||||
MULTICA_GOOGLE_CLIENT_SECRET=
|
||||
MULTICA_GOOGLE_REDIRECT_URI=http://localhost:3000/auth/callback
|
||||
|
||||
# Resources - PostgreSQL
|
||||
MULTICA_POSTGRES_CPU_LIMIT=1.00
|
||||
MULTICA_POSTGRES_MEMORY_LIMIT=1G
|
||||
MULTICA_POSTGRES_CPU_RESERVATION=0.25
|
||||
MULTICA_POSTGRES_MEMORY_RESERVATION=256M
|
||||
|
||||
# Resources - Backend
|
||||
MULTICA_BACKEND_CPU_LIMIT=2.00
|
||||
MULTICA_BACKEND_MEMORY_LIMIT=2G
|
||||
MULTICA_BACKEND_CPU_RESERVATION=0.50
|
||||
MULTICA_BACKEND_MEMORY_RESERVATION=512M
|
||||
|
||||
# Resources - Frontend
|
||||
MULTICA_FRONTEND_CPU_LIMIT=1.00
|
||||
MULTICA_FRONTEND_MEMORY_LIMIT=1G
|
||||
MULTICA_FRONTEND_CPU_RESERVATION=0.25
|
||||
MULTICA_FRONTEND_MEMORY_RESERVATION=256M
|
||||
|
||||
# Logging
|
||||
MULTICA_LOG_MAX_SIZE=100m
|
||||
MULTICA_LOG_MAX_FILE=3
|
||||
|
||||
# Timezone
|
||||
TZ=UTC
|
||||
@@ -0,0 +1,77 @@
|
||||
# Multica
|
||||
|
||||
[English](./README.md) | [中文](./README.zh.md)
|
||||
|
||||
Multica is an open-source managed agents platform that turns coding agents into real teammates. Assign tasks, track progress, and compound reusable skills — works with Claude Code, Codex, OpenClaw, and OpenCode. This Compose setup builds the Go backend and Next.js frontend from source, starts PostgreSQL with pgvector, and exposes both services.
|
||||
|
||||
## Services
|
||||
|
||||
- **multica-backend**: Go backend (Chi router, sqlc, gorilla/websocket) with auto-migration on startup
|
||||
- **multica-frontend**: Next.js 16 web application (App Router, standalone output)
|
||||
- **multica-postgres**: PostgreSQL 17 with pgvector extension
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. Copy the example environment file:
|
||||
|
||||
```bash
|
||||
cp .env.example .env
|
||||
```
|
||||
|
||||
2. Edit `.env` and change `MULTICA_JWT_SECRET` to a secure random value:
|
||||
|
||||
```bash
|
||||
MULTICA_JWT_SECRET=$(openssl rand -base64 32)
|
||||
```
|
||||
|
||||
3. Start the stack (first run builds images from source — this takes several minutes):
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
4. Open Multica:
|
||||
|
||||
- Frontend: <http://localhost:3000>
|
||||
- Backend API: <http://localhost:8080>
|
||||
|
||||
## Default Ports
|
||||
|
||||
| Service | Port | Description |
|
||||
| -------- | ---- | ---------------------- |
|
||||
| Frontend | 3000 | Web UI |
|
||||
| Backend | 8080 | REST API and WebSocket |
|
||||
| Postgres | 5432 | Internal only |
|
||||
|
||||
## Important Environment Variables
|
||||
|
||||
| Variable | Description | Default |
|
||||
| -------------------------------- | ------------------------------------------ | ------------------------- |
|
||||
| `MULTICA_VERSION` | Git ref used for source builds | `v0.1.32` |
|
||||
| `MULTICA_BACKEND_PORT_OVERRIDE` | Host port for the backend API | `8080` |
|
||||
| `MULTICA_FRONTEND_PORT_OVERRIDE` | Host port for the web UI | `3000` |
|
||||
| `MULTICA_JWT_SECRET` | JWT signing secret (change for production) | `change-me-in-production` |
|
||||
| `MULTICA_POSTGRES_PASSWORD` | PostgreSQL password | `multica` |
|
||||
| `MULTICA_FRONTEND_ORIGIN` | Frontend URL for CORS and cookies | `http://localhost:3000` |
|
||||
| `MULTICA_GOOGLE_CLIENT_ID` | Google OAuth client ID (optional) | - |
|
||||
| `MULTICA_GOOGLE_CLIENT_SECRET` | Google OAuth client secret (optional) | - |
|
||||
| `MULTICA_RESEND_API_KEY` | Resend API key for email (optional) | - |
|
||||
| `TZ` | Container timezone | `UTC` |
|
||||
|
||||
## Storage
|
||||
|
||||
| Volume | Description |
|
||||
| ---------------- | --------------- |
|
||||
| `multica_pgdata` | PostgreSQL data |
|
||||
|
||||
## Security Notes
|
||||
|
||||
- Always change `MULTICA_JWT_SECRET` before exposing the service.
|
||||
- Change `MULTICA_POSTGRES_PASSWORD` for production deployments.
|
||||
- Google OAuth and email (Resend) are optional; the platform works without them.
|
||||
- The first build downloads the full Multica repository from GitHub and builds Docker images, so it requires internet access and may take several minutes.
|
||||
|
||||
## References
|
||||
|
||||
- [Multica Repository](https://github.com/multica-ai/multica)
|
||||
- [Self-Hosting Guide](https://github.com/multica-ai/multica/blob/main/SELF_HOSTING.md)
|
||||
@@ -0,0 +1,77 @@
|
||||
# Multica
|
||||
|
||||
[English](./README.md) | [中文](./README.zh.md)
|
||||
|
||||
Multica 是一个开源的托管 Agent 平台，能将编码 Agent 变成真正的团队成员。分配任务、跟踪进度、积累可复用技能——支持 Claude Code、Codex、OpenClaw 和 OpenCode。此 Compose 配置从源码构建 Go 后端和 Next.js 前端，启动带有 pgvector 扩展的 PostgreSQL，并暴露两个服务。
|
||||
|
||||
## 服务
|
||||
|
||||
- **multica-backend**：Go 后端（Chi 路由、sqlc、gorilla/websocket），启动时自动执行数据库迁移
|
||||
- **multica-frontend**：Next.js 16 Web 应用（App Router，standalone 输出）
|
||||
- **multica-postgres**：PostgreSQL 17，包含 pgvector 扩展
|
||||
|
||||
## 快速开始
|
||||
|
||||
1. 复制环境变量示例文件：
|
||||
|
||||
```bash
|
||||
cp .env.example .env
|
||||
```
|
||||
|
||||
2. 编辑 `.env`，将 `MULTICA_JWT_SECRET` 修改为安全的随机值：
|
||||
|
||||
```bash
|
||||
MULTICA_JWT_SECRET=$(openssl rand -base64 32)
|
||||
```
|
||||
|
||||
3. 启动服务（首次运行会从源码构建镜像，需要几分钟）：
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
4. 打开 Multica：
|
||||
|
||||
- 前端界面：<http://localhost:3000>
|
||||
- 后端 API：<http://localhost:8080>
|
||||
|
||||
## 默认端口
|
||||
|
||||
| 服务 | 端口 | 说明 |
|
||||
| -------- | ---- | --------------------- |
|
||||
| Frontend | 3000 | Web 界面 |
|
||||
| Backend | 8080 | REST API 和 WebSocket |
|
||||
| Postgres | 5432 | 仅内部访问 |
|
||||
|
||||
## 关键环境变量
|
||||
|
||||
| 变量 | 说明 | 默认值 |
|
||||
| -------------------------------- | ---------------------------------- | ------------------------- |
|
||||
| `MULTICA_VERSION` | 用于源码构建的 Git 引用 | `v0.1.32` |
|
||||
| `MULTICA_BACKEND_PORT_OVERRIDE` | 后端 API 对外端口 | `8080` |
|
||||
| `MULTICA_FRONTEND_PORT_OVERRIDE` | Web 界面对外端口 | `3000` |
|
||||
| `MULTICA_JWT_SECRET` | JWT 签名密钥（生产环境必须修改） | `change-me-in-production` |
|
||||
| `MULTICA_POSTGRES_PASSWORD` | PostgreSQL 密码 | `multica` |
|
||||
| `MULTICA_FRONTEND_ORIGIN` | 前端 URL，用于 CORS 和 Cookie 设置 | `http://localhost:3000` |
|
||||
| `MULTICA_GOOGLE_CLIENT_ID` | Google OAuth 客户端 ID（可选） | - |
|
||||
| `MULTICA_GOOGLE_CLIENT_SECRET` | Google OAuth 客户端密钥（可选） | - |
|
||||
| `MULTICA_RESEND_API_KEY` | Resend 邮件服务的 API Key（可选） | - |
|
||||
| `TZ` | 容器时区 | `UTC` |
|
||||
|
||||
## 存储
|
||||
|
||||
| 卷 | 说明 |
|
||||
| ---------------- | --------------- |
|
||||
| `multica_pgdata` | PostgreSQL 数据 |
|
||||
|
||||
## 安全说明
|
||||
|
||||
- 在对外暴露服务前，务必修改 `MULTICA_JWT_SECRET`。
|
||||
- 生产环境部署时请修改 `MULTICA_POSTGRES_PASSWORD`。
|
||||
- Google OAuth 和邮件服务（Resend）均为可选配置，平台在没有它们的情况下也能正常运行。
|
||||
- 首次构建需要从 GitHub 下载完整的 Multica 仓库并构建 Docker 镜像，因此需要联网，可能需要几分钟。
|
||||
|
||||
## 参考资料
|
||||
|
||||
- [Multica 仓库](https://github.com/multica-ai/multica)
|
||||
- [自托管指南](https://github.com/multica-ai/multica/blob/main/SELF_HOSTING.md)
|
||||
@@ -0,0 +1,109 @@
|
||||
x-defaults: &defaults
|
||||
restart: unless-stopped
|
||||
logging:
|
||||
driver: json-file
|
||||
options:
|
||||
max-size: ${MULTICA_LOG_MAX_SIZE:-100m}
|
||||
max-file: '${MULTICA_LOG_MAX_FILE:-3}'
|
||||
|
||||
services:
|
||||
multica-postgres:
|
||||
<<: *defaults
|
||||
image: ${GLOBAL_REGISTRY:-}pgvector/pgvector:${MULTICA_PGVECTOR_VERSION:-pg17}
|
||||
environment:
|
||||
- TZ=${TZ:-UTC}
|
||||
- POSTGRES_DB=${MULTICA_POSTGRES_DB:-multica}
|
||||
- POSTGRES_USER=${MULTICA_POSTGRES_USER:-multica}
|
||||
- POSTGRES_PASSWORD=${MULTICA_POSTGRES_PASSWORD:-multica}
|
||||
volumes:
|
||||
- multica_pgdata:/var/lib/postgresql/data
|
||||
healthcheck:
|
||||
test: [CMD-SHELL, pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 10s
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: ${MULTICA_POSTGRES_CPU_LIMIT:-1.00}
|
||||
memory: ${MULTICA_POSTGRES_MEMORY_LIMIT:-1G}
|
||||
reservations:
|
||||
cpus: ${MULTICA_POSTGRES_CPU_RESERVATION:-0.25}
|
||||
memory: ${MULTICA_POSTGRES_MEMORY_RESERVATION:-256M}
|
||||
|
||||
multica-backend:
|
||||
<<: *defaults
|
||||
build:
|
||||
context: https://github.com/multica-ai/multica.git#${MULTICA_VERSION:-v0.1.32}
|
||||
dockerfile: Dockerfile
|
||||
depends_on:
|
||||
multica-postgres:
|
||||
condition: service_healthy
|
||||
ports:
|
||||
- '${MULTICA_BACKEND_PORT_OVERRIDE:-8080}:8080'
|
||||
environment:
|
||||
- TZ=${TZ:-UTC}
|
||||
- DATABASE_URL=postgres://${MULTICA_POSTGRES_USER:-multica}:${MULTICA_POSTGRES_PASSWORD:-multica}@multica-postgres:5432/${MULTICA_POSTGRES_DB:-multica}?sslmode=disable
|
||||
- PORT=8080
|
||||
- JWT_SECRET=${MULTICA_JWT_SECRET:-change-me-in-production}
|
||||
- FRONTEND_ORIGIN=${MULTICA_FRONTEND_ORIGIN:-http://localhost:3000}
|
||||
- CORS_ALLOWED_ORIGINS=${MULTICA_CORS_ALLOWED_ORIGINS:-}
|
||||
- MULTICA_APP_URL=${MULTICA_APP_URL:-http://localhost:3000}
|
||||
- RESEND_API_KEY=${MULTICA_RESEND_API_KEY:-}
|
||||
- RESEND_FROM_EMAIL=${MULTICA_RESEND_FROM_EMAIL:-noreply@multica.ai}
|
||||
- GOOGLE_CLIENT_ID=${MULTICA_GOOGLE_CLIENT_ID:-}
|
||||
- GOOGLE_CLIENT_SECRET=${MULTICA_GOOGLE_CLIENT_SECRET:-}
|
||||
- GOOGLE_REDIRECT_URI=${MULTICA_GOOGLE_REDIRECT_URI:-http://localhost:3000/auth/callback}
|
||||
- COOKIE_DOMAIN=${MULTICA_COOKIE_DOMAIN:-}
|
||||
healthcheck:
|
||||
test:
|
||||
- CMD-SHELL
|
||||
- wget --no-verbose --tries=1 --spider http://127.0.0.1:8080/ || exit 1
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 5
|
||||
start_period: 60s
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: ${MULTICA_BACKEND_CPU_LIMIT:-2.00}
|
||||
memory: ${MULTICA_BACKEND_MEMORY_LIMIT:-2G}
|
||||
reservations:
|
||||
cpus: ${MULTICA_BACKEND_CPU_RESERVATION:-0.50}
|
||||
memory: ${MULTICA_BACKEND_MEMORY_RESERVATION:-512M}
|
||||
|
||||
multica-frontend:
|
||||
<<: *defaults
|
||||
build:
|
||||
context: https://github.com/multica-ai/multica.git#${MULTICA_VERSION:-v0.1.32}
|
||||
dockerfile: Dockerfile.web
|
||||
args:
|
||||
REMOTE_API_URL: http://multica-backend:8080
|
||||
NEXT_PUBLIC_GOOGLE_CLIENT_ID: ${MULTICA_GOOGLE_CLIENT_ID:-}
|
||||
depends_on:
|
||||
- multica-backend
|
||||
ports:
|
||||
- '${MULTICA_FRONTEND_PORT_OVERRIDE:-3000}:3000'
|
||||
environment:
|
||||
- TZ=${TZ:-UTC}
|
||||
- HOSTNAME=0.0.0.0
|
||||
healthcheck:
|
||||
test:
|
||||
- CMD-SHELL
|
||||
- wget --no-verbose --tries=1 --spider http://127.0.0.1:3000/ || exit 1
|
||||
interval: 30s
|
||||
timeout: 10s
|
||||
retries: 5
|
||||
start_period: 60s
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: ${MULTICA_FRONTEND_CPU_LIMIT:-1.00}
|
||||
memory: ${MULTICA_FRONTEND_MEMORY_LIMIT:-1G}
|
||||
reservations:
|
||||
cpus: ${MULTICA_FRONTEND_CPU_RESERVATION:-0.25}
|
||||
memory: ${MULTICA_FRONTEND_MEMORY_RESERVATION:-256M}
|
||||
|
||||
volumes:
|
||||
multica_pgdata:
|
||||
Reference in New Issue
Block a user