# Pure-RuoYi-FastAPI

**Repository Path**: 9658065/RuoYi-Vue3-FastAPI

## Basic Information

- **Project Name**: Pure-RuoYi-FastAPI
- **Description**: 基于Vue3+Element Plus+FastAPI开发的一个通用中后台管理框架（若依的FastAPI版本），支持代码生成
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://vfadmin.insistence.tech/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 371
- **Created**: 2025-10-24
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
	<img alt="logo" src="./pure-admin/public/logo.png">
</p>
<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Pure-RuoYi-FastAPI v1.7.1</h1>
<h4 align="center">基于pure-admin界面框架适配RuoYi-FastAPI后端的快速开发平台</h4>
<p align="center">
	<a href="https://gitee.com/insistence2022/RuoYi-Vue3-FastAPI/stargazers"><img src="https://gitee.com/insistence2022/RuoYi-Vue3-FastAPI/badge/star.svg?theme=dark"></a>
    <a href="https://github.com/insistence/RuoYi-Vue3-FastAPI"><img src="https://img.shields.io/github/stars/insistence/RuoYi-Vue3-FastAPI?style=social"></a>
	<a href="https://gitee.com/insistence2022/RuoYi-Vue3-FastAPI"><img src="https://img.shields.io/badge/PureRuoYiFastAPI-v1.7.1-brightgreen.svg"></a>
	<a href="https://gitee.com/insistence2022/RuoYi-Vue3-FastAPI/blob/master/LICENSE"><img src="https://img.shields.io/github/license/mashape/apistatus.svg"></a>
    <img src="https://img.shields.io/badge/node-≥18-blue">
    <img src="https://img.shields.io/badge/python-≥3.9-blue">
    <img src="https://img.shields.io/badge/Vue-3.5-blue">
    <img src="https://img.shields.io/badge/ElementPlus-2.11-blue">
    <img src="https://img.shields.io/badge/MySQL-≥5.7-blue">
</p>

## 项目简介

Pure-RuoYi-FastAPI 是一套全部开源的快速开发平台，将 pure-admin 优雅的界面框架与 RuoYi-FastAPI 强大的后端功能完美结合。作者因喜欢 pure-admin 的现代化界面设计和流畅的用户体验，对 RuoYi-FastAPI 项目进行了前端改造，完全适配后端功能，提供了一套全新的快速开发解决方案。

## 快速开始

### 环境要求

- **前端**：Node.js ≥ 18, pnpm ≥ 8
- **后端**：Python ≥ 3.9
- **数据库**：MySQL ≥ 5.7 或 PostgreSQL
- **缓存**：Redis

### 开发环境运行

#### 1. 克隆项目

```bash
# 克隆项目
git clone https://gitee.com/insistence2022/RuoYi-Vue3-FastAPI.git

# 进入项目根目录
cd RuoYi-Vue3-FastAPI
```

#### 2. 后端运行

```bash
# 进入后端目录
cd ruoyi-fastapi-backend

# 安装依赖（MySQL版本）
pip install -r requirements.txt
# 或者安装依赖（PostgreSQL版本）
pip install -r requirements-pg.txt

# 配置环境
# 编辑 .env.dev 文件，配置数据库和Redis连接信息

# 初始化数据库
# 1. 创建数据库 ruoyi-fastapi
# 2. 运行对应数据库的SQL文件（sql文件夹下）

# 启动后端服务
python app.py --env=dev
```

#### 3. 前端运行（pure-admin 版本）

```bash
# 返回项目根目录
cd ..

# 进入前端目录
cd pure-admin

# 安装依赖
pnpm install

# 配置环境（可选）
# 编辑 .env.development 文件，配置后端API地址

# 启动前端服务
pnpm dev
```

#### 4. 访问系统

```bash
# 默认账号密码
账号：admin
密码：admin123

# 访问地址
pure-admin版本：http://localhost:3000
```

### 生产环境部署

#### 后端部署

```bash
# 配置生产环境
# 编辑 .env.prod 文件

# 启动服务
python app.py --env=prod
```

#### 前端部署

```bash
# 构建生产版本
pnpm build

# 部署dist目录到Nginx或其他Web服务器
```

## 项目结构说明

- **pure-admin/**: 基于 pure-admin 改造的前端框架
- **ruoyi-fastapi-backend/**: FastAPI 后端服务
- **ruoyi-fastapi-frontend/**: 原 RuoYi 前端实现

## 更多信息

### 功能特性

请查看 <mcfile name="ruoyi-fastapi-README.md" path="ruoyi-fastapi-README.md">ruoyi-fastapi README</mcfile> 获取详细的功能介绍。

### 技术文档

完整的技术栈和详细说明请参考原 README 文件内容。

## 许可证

[MIT](LICENSE)