Skip to content

rrg1225/nextgen-ai-starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 NextGen-AI-Starter

10 分钟,拥有专属 AI 对话应用 —— 零数据库配置,开箱即用,填入 API Key 即刻起飞。

Spring Boot Vue.js TypeScript Java OpenAI API SSE License: MIT

GitHub Stars GitHub Forks GitHub License GitHub Issues

Spring Boot 3 多模块后端 × Vue 3 极简前端 × 真·流式打字机

⚡ 快速开始 · ✨ 核心特性 · 🗺️ 发展路线 · 📄 协议


💡 一句话,说清价值

NextGen-AI-Starter 是面向开发者的 轻量级 AI 应用脚手架 —— 没有臃肿中间件,没有「先配数据库再说话」的劝退流程。

git clone  →  填入 API Key  →  前后端启动  →  浏览器开聊

不到 10 分钟,你就能跑起一个带 ChatGPT 级流式体验 的专属对话应用。
适合个人助手、内部 Copilot 原型、教学 Demo,以及任何想 快速验证 AI 想法 的场景。


✨ 核心特性 (Features)

🧱 极简多模块架构 starter-common · starter-core · starter-web —— 职责边界清晰,源码可读、可 Fork、可魔改,拒绝过度封装。
🔌 OpenAI 协议兼容 一套 AiChatService 打通 OpenAI 官方、阿里云百炼 compatible-mode、自建 OpenClaw 网关 —— 改配置,不换代码。
⚡ 丝滑真·流式 后端 Spring WebFlux + SSE,前端 原生 Fetch 流式解析 —— 逐字打字机效果,拒绝「整段 JSON 假装流式」。
🪶 零包袱启动 无需 MySQL / Redis 即可完整体验核心对话。数据库脚本已躺在 deploy/,你要用时再启用。
🎨 开箱即用 UI 清爽对话气泡,无强制登录、无填表弹窗 —— 打开页面,直接聊。

📁 项目结构

NextGen-AI-Starter/
├── ai-backend/                    # Spring Boot 3 多模块
│   ├── starter-common/              # 公共能力
│   ├── starter-core/                # 大模型接入 & 流式 Service
│   └── starter-web/                 # API & 启动类
├── ai-frontend/                     # Vue 3 + Vite + TypeScript
│   └── src/views/chat/              # 核心聊天页
├── deploy/init.sql                  # MySQL 脚本(v1.0 可选)
└── docs/screenshot.png              # 界面截图(你来放一张帅的)

🚀 快速开始 (Quick Start)

0️⃣ 拉取代码

git clone https://github.com/rrg1225/nextgen-ai-starter.git
cd nextgen-ai-starter

环境准备

工具 版本
JDK 17+
Maven 3.8+
Node.js 18+

后端:3 步起飞

# ① 进入后端目录
cd ai-backend

# ② 复制配置模板 → 填入你的 API Key(关键一步!)
cp starter-web/src/main/resources/application-dev.yml.example \
   starter-web/src/main/resources/application-dev.yml

打开 application-dev.yml,填入密钥(百炼示例):

ai:
  api-key: your-api-key-here
  base-url: https://dashscope.aliyuncs.com/compatible-mode
  model: qwen-plus
# ③ 启动(默认 http://localhost:8080)
mvn spring-boot:run -pl starter-web

✅ 控制台出现 Started NextGenAiApplication —— 后端已就绪。

🔐 application-dev.yml 已被 .gitignore 忽略,放心填 Key,别提交到 Git。


前端:2 行命令

cd ai-frontend
npm install && npm run dev

🌐 打开 http://localhost:5173
本地已配置 Vite 代理 /api8080,无需折腾跨域环境变量。


开聊 🎉

输入问题,Enter 发送 —— 看 AI 在左侧灰色气泡里一字一字「打」出来。
就这么简单,没有别的仪式。


📸 界面截图

📌 请将你的运行截图保存为 docs/screenshot.png,README 将自动展示。

聊天界面截图


🗺️ 发展路线 (Roadmap / TODO)

🔥 v1.0 今日发布 —— 少即是多

这是我们的极客态度:

为了保持 v1.0 的极简与轻量,我们 今天坚决不再加任何新代码 ——
流式对话、OpenAI 兼容接入、清爽 UI,已经足够好用。
直接发布。现在。立刻。

不堆功能、不画大饼,先把 「能跑、能聊、能 Fork」 这件事做到极致。
如果你认同 「先 Ship,再迭代」 的理念 —— 请现在就点个 ⭐ Star,这是对 v1.0 最好的投票。


🌱 未来优化方向(持续进化中)

点个 Star 关注仓库,我们会在后续版本逐步实现:

  • 接入数据库 — 支持多会话管理与历史记录,告别刷新即失忆
  • 集成向量库 — 支持 RAG(检索增强生成),基于本地文档的智能问答

💬 有更好的想法?欢迎提 Issue / PR,一起把 NextGen-AI-Starter 打造成 最好上手的 Java AI 脚手架


🤝 参与贡献

  1. Fork 本仓库
  2. 创建分支:git checkout -b feature/your-idea
  3. 提交:git commit -m 'feat: something awesome'
  4. 发起 Pull Request

⚠️ 请勿提交 application-dev.yml.env 等含敏感信息的文件。


📄 开源协议

本项目采用 MIT License 开源。

你可以自由使用、修改与商用,保留版权声明即可。完整条款见 LICENSE


⭐ 如果它帮你节省了哪怕 10 分钟,请给一个 Star

让更多开发者,10 分钟拥有自己的 AI 应用。

👉 github.com/rrg1225/nextgen-ai-starter — 顺手点个 Star,是对 v1.0 最好的鼓励。


Made with ❤️ & ☕ by NextGen-AI-Starter

About

🚀 开箱即用的企业级 AI 全栈脚手架 (Spring Boot 3 + Vue 3)。零数据库配置,填入 API Key 即可启动。基于 WebFlux + SSE 实现极致丝滑的“真·打字机”流式对话,完美兼容 OpenAI 与阿里云大模型协议。10分钟极速构建你的专属 AI 应用!A lightweight AI full-stack boilerplate.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors