AIdea 服务器 - AI 聊天、协作与图像生成

英语 | 简体中文

一款基于 Go 语言构建的完全开源 APP 服务器，集成了主流的大语言模型和图像生成模型。

立即体验：

https://aidea.aicode.cc

开源仓库：

• 客户端：https://github.com/mylxsw/aidea
• 服务器：https://github.com/mylxsw/aidea-server
• Docker 部署：https://github.com/mylxsw/aidea-docker

自行部署

如果您不想使用托管的云服务，也可以自行部署本服务器。请参阅此处的部署指南。

若您希望由他人代为完成部署，欢迎联系我们获取协助。详情请参阅服务器协助部署。

社区

• 微信技术交流群：

  

  如无法加入，请添加微信 ID x-prometheus 为好友，我们将邀请您入群。

• 微信公众号

  

关于代码

目前代码注释和技术文档较为有限，后续会逐步补充。请注意以下几点，以免混淆：

• 代码中的 Room 和 Advisory Group 都指代 Digital Persona。由于多次迭代，命名经历了从 Room 到 Advisory Group 再到 Digital Persona 的演变。
• v1 版本的 Creation Island 与 v2 版本完全不同。v1 曾服务于 App 1.0.1 及以下版本；自 1.0.2 版本起便不再使用，因此推出了 v2 版本。

本项目使用的框架：

• Glacier Framework：一款内部开发的模块化应用框架，支持依赖注入，基于 go-ioc IoC 容器构建。它解决了 Go 应用程序中的依赖传递和模块化问题。
• Eloquent ORM：一款受 Laravel PHP 框架启发、基于代码生成的内部 ORM 框架，支持 MySQL 等多种数据库。

代码结构：

目录	描述
api	兼容 OpenAI 的 API；此处的端点可被任何支持 OpenAI API 协议的第三方软件直接使用
server	为 AIdea 客户端应用提供的 API 端点
config	配置定义与管理
migrate	数据库迁移文件（SQL）
cmd	应用程序入口点
pkg	可被其他项目导入的公共包
⌞ ai	各类模型提供商的 AI 模型接口实现
⌞ ai/chat	抽象聊天模型接口；所有聊天模型均在此处封装，以兼容 OpenAI Chat Stream 协议
⌞ aliyun	阿里云短信及内容安全服务实现
⌞ dingding	钉钉通知机器人
⌞ misc	各种辅助函数
⌞ jobs	定时任务，例如每日用户令牌消耗统计
⌞ mail	邮件发送
⌞ proxy	SOCKS5 代理实现
⌞ rate	限流实现
⌞ redis	Redis 实例
⌞ repo	数据模型层；封装了所有数据库操作
⌞ repo/model	使用 mylxsw/eloquent 定义的数据模型
⌞ service	位于 Controller 和 Repo 层之外的业务逻辑层
⌞ sms	统一的短信服务抽象，将底层短信提供商的实现对业务逻辑透明化
⌞ tencent	腾讯语音转文字及短信服务实现
⌞ token	JWT Token
⌞ uploader	基于七牛云存储的文件上传/下载服务
⌞ voice	基于七牛云的文本转语音服务（目前已禁用）
⌞ youdao	有道翻译 API 实现
internal	内部包；仅在本项目内可用
⌞ queue	任务队列实现；所有异步处理的任务都在此处定义
⌞ queue/consumer	任务队列消费者
⌞ payment	在线支付服务实现（如支付宝、Apple Pay 等）
⌞ coins	服务定价与计费策略
config.yaml	示例配置文件
coins-table.yaml	示例定价表配置
nginx.conf	示例 Nginx 配置
systemd.service	示例 Systemd 服务配置

构建项目：

go build -o build/debug/aidea-server cmd/main.go

App 截图

浅色主题

深色主题

星级历史

许可证

MIT

版权所有 © 2023, mylxsw

AIdea Server 快速上手指南

AIdea Server 是一个基于 Golang 构建的全开源应用服务器，集成了主流大语言模型（LLM）和图像生成模型，支持 AI 聊天、协作及图片生成功能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux / macOS / Windows (推荐 Linux 部署)
• Go 语言环境：Go 1.20 或更高版本
• 数据库：MySQL 8.0+ 或兼容的数据库
• 缓存服务：Redis
• 其他依赖：
  • Git (用于克隆代码)
  • Nginx (可选，用于反向代理)

提示：本项目使用了自研的 Glacier 框架和 Eloquent ORM，构建时会自动处理依赖，无需手动安装额外 Go 包管理工具（除标准的 go mod 外）。

安装步骤

1. 克隆项目代码

git clone https://github.com/mylxsw/aidea-server.git
cd aidea-server

2. 配置环境变量与数据库

复制示例配置文件并根据实际需求修改（主要是数据库连接、Redis 地址及 AI 模型密钥）：

cp config.yaml config.local.yaml
# 请使用编辑器修改 config.local.yaml 中的 database, redis 及 ai provider 配置

初始化数据库结构（项目使用迁移文件管理表结构）：

• 确保 MySQL 和 Redis 服务已启动。
• 程序首次运行时通常会自动执行迁移，或者您可以检查 migrate 目录下的 SQL 文件手动执行。

3. 编译构建

使用 Go 原生命令进行构建：

go build -o build/debug/aidea-server cmd/main.go

构建成功后，可执行文件将位于 build/debug/aidea-server。

Docker 部署方案： 如果您更倾向于容器化部署，可以直接使用官方提供的 Docker 编排方案：

git clone https://github.com/mylxsw/aidea-docker.git
cd aidea-docker
# 参考该仓库 README 进行 docker-compose up 操作

基本使用

启动服务

运行编译好的二进制文件（默认读取当前目录下的 config.local.yaml 或 config.yaml）：

./build/debug/aidea-server

服务启动后，默认会监听配置的端口（通常为 HTTP 服务）。

验证服务

1. API 测试： 该项目提供了兼容 OpenAI 协议的 API 接口。您可以使用任何支持 OpenAI 格式的客户端（如 Postman、curl 或第三方 AI 客户端）指向您的服务器地址进行测试。

   接口路径位于 api 目录下定义的端点。

2. 连接客户端： 下载并安装 AIdea 客户端（来源：https://github.com/mylxsw/aidea），在设置中将服务器地址指向您自建的 aidea-server 地址，即可体验完整的聊天、协作及绘图功能。

核心功能说明

• 数字人格 (Digital Persona)：对应代码中的 Room 或 Advisory Group，用于创建不同角色的 AI 助手。
• 多模型支持：通过配置 config.yaml 中的 AI Provider，可灵活切换阿里云、腾讯云或其他兼容 OpenAI 接口的模型服务商。
• 任务队列：异步任务（如统计、通知）通过内置的 queue 模块处理，确保主服务高性能运行。