GeminiImageApp 的安装和配置教程

1. 项目基础介绍和主要编程语言

GeminiImageApp 是一个基于 Google Gemini AI 的全功能图像处理应用。它是一个现代化的全栈 AI 图像处理平台，集成了 Google Gemini、OpenCV 和 YOLO 等先进技术，提供图像问答、生成、编辑、目标检测、图像分割和视频生成等功能。

该项目主要使用 Python 作为后端编程语言，Vue.js 作为前端框架。

2. 项目使用的关键技术和框架

• 后端技术栈: Flask 3.0+ (现代化 Web 框架), google-genai 1.16.1 (最新 Gemini AI SDK), OpenCV 4.x (计算机视觉库), Ultralytics YOLO v11 (最新目标检测模型), Pillow (PIL) (图像处理库), Python 3.8+ (运行环境)
• 前端技术栈: Vue.js 3 (渐进式 JavaScript 框架), Vite (快速构建工具), TailwindCSS (原子化 CSS 框架), Element Plus (Vue 3 组件库), Font Awesome (图标库), 响应式设计 (移动端适配)

3. 项目安装和配置的准备工作

在开始安装和配置之前，请确保您已经安装了以下软件和工具：

• Python 3.8+
• Node.js 16+ (用于前端开发)
• Git (版本控制)
• Google AI API Key (必需)

3.1 克隆项目

首先，您需要克隆项目到本地：

git clone https://github.com/yourusername/gemini-image-app.git
cd gemini-image-app

请将 yourusername 替换为您自己的 GitHub 用户名。

3.2 后端设置

进入后端目录：

cd backend

创建虚拟环境 (推荐):

python -m venv .venv

激活虚拟环境：

source .venv/bin/activate  # Linux/Mac

或

.venv\Scripts\activate  # Windows

安装依赖：

pip install -r requirements.txt

3.3 前端设置

进入前端目录：

cd frontend

安装依赖：

npm install

启动开发服务器：

npm run dev

3.4 环境配置

复制环境变量模板：

cp .env.example .env

编辑 .env 文件，添加您的 API 密钥：

GOOGLE_API_KEY=your_google_ai_api_key_here
GEMINI_API_KEY=your_google_ai_api_key_here
SECRET_KEY=your_random_secret_key_here

请将 your_google_ai_api_key_here 替换为您从 Google AI Studio 获取的 API 密钥。

3.5 启动应用

启动后端服务 (端口 5000):

cd backend
python run.py

启动前端服务 (端口 3000):

cd frontend
npm run dev

3.6 访问应用

前端界面:

http://localhost:3000

后端API:

http://localhost:5000

恭喜！您的 Gemini Image App 已经运行起来了！