超级AI代理

Option 1: Docker Compose (Recommended)

If you have Docker installed, this is the easiest way:

```bash

Option 2: Local Manual Setup

1. Prerequisites

• ✅ Java 21+
• ✅ Node.js 18+
• ✅ Maven 3.8+
• ✅ MySQL 8.0+
• ✅ PostgreSQL 14+ (with PGVector extension)
• ✅ Alibaba Cloud DashScope API Key

2. Clone the Repository

git clone https://github.com/muonuo/Super-ai-agent.git
cd Super-ai-agent

3. Configure Databases

MySQL Setup:

-- Create database
CREATE DATABASE super_ai_agent CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Tables are auto-created, no manual SQL needed

PostgreSQL + PGVector Setup:

-- Create database
CREATE DATABASE super_ai_agent;

-- Install PGVector extension (Spring AI will auto-initialize vector tables)
CREATE EXTENSION IF NOT EXISTS vector;

4. Configure Environment Variables

Edit src/main/resources/application.yml:

```yaml

Q3: PGVector Extension Not Installed

PostgreSQL requires the PGVector extension:

```bash

Q4: Maven Build Failed

Make sure you're using Java 21 and Maven 3.8+:

java -version
mvn -version

🚀 Quick Start

🛠️ Development Guide

🎯 Usage Examples

📸 Screenshots

1. Set environment variables

export DASHSCOPE_API_KEY=your_api_key export MYSQL_PASSWORD=your_password export POSTGRESQL_PASSWORD=your_password

MySQL config

spring: datasource: url: jdbc:mysql://localhost:3306/super_ai_agent?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: your_mysql_password

# AI config (required) ai: dashscope: api-key: your_dashscope_api_key # Get it at https://dashscope.console.aliyun.com/

PostgreSQL config

pgvector: datasource: url: jdbc:postgresql://localhost:5432/super_ai_agent username: postgres password: your_postgresql_password

Optional config

search-api: tavily-api-key: your_tavily_api_key # For web search qq-email: from: your_qq_email auth-code: your_qq_email_auth_code # For sending love reports

> 💡 **Getting a DashScope API Key:**
>
> 1. Visit https://dashscope.console.aliyun.com/
> 2. Register/login to Alibaba Cloud
> 3. Enable DashScope service
> 4. Create an API Key
> 5. New users get free credits

#### 5. Start Backend

Option A: Using Maven (recommended)

cd Super-ai-agent mvn clean package -DskipTests java -jar target/Super-ai-agent-0.0.1-SNAPSHOT.jar

Option B: Using IDE

Backend Swagger UI: http://localhost:8123/api/swagger-ui.html

Q5: DashScope API Key Not Found

1. Visit https://dashscope.console.aliyun.com/
2. Register/login to Alibaba Cloud
3. Enable DashScope service
4. Create an API Key
5. New users get free credits

---

❓ FAQ