https://github.com/sleep1223/fast-soy-admin
基于 FastAPI+Vue3+Naive UI 的现代化轻量管理平台。 A modern Management Platform based on FastAPI+Vue3+Naive UI.
https://github.com/sleep1223/fast-soy-admin
admin admin-template fastapi fastapi-admin naive-ui pinia pydantic python tortoise-orm typescript unocss vite5 vue vue-admin vue3
Last synced: 20 days ago
JSON representation
基于 FastAPI+Vue3+Naive UI 的现代化轻量管理平台。 A modern Management Platform based on FastAPI+Vue3+Naive UI.
- Host: GitHub
- URL: https://github.com/sleep1223/fast-soy-admin
- Owner: sleep1223
- License: mit
- Created: 2024-05-17T14:59:48.000Z (almost 2 years ago)
- Default Branch: dev
- Last Pushed: 2026-03-26T01:20:30.000Z (about 1 month ago)
- Last Synced: 2026-03-26T11:58:22.058Z (about 1 month ago)
- Topics: admin, admin-template, fastapi, fastapi-admin, naive-ui, pinia, pydantic, python, tortoise-orm, typescript, unocss, vite5, vue, vue-admin, vue3
- Language: TypeScript
- Homepage: https://fast-soy-admin2.sleep0.de/
- Size: 1.08 MB
- Stars: 295
- Watchers: 6
- Forks: 78
- Open Issues: 3
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE
Awesome Lists containing this project
README
# FastSoyAdmin
[](./LICENSE)
[](https://github.com/sleep1223/fast-soy-admin)
[](https://github.com/sleep1223/fast-soy-admin)
[](https://github.com/Microsoft/pyright)
[](https://github.com/astral-sh/ruff)
[](https://deepwiki.com/sleep1223/fast-soy-admin)
English | 中文
> [!NOTE]
> If `FastSoyAdmin` is helpful to you, please give us a ⭐️ on GitHub. Your support means the world to us!
## Introduction
[`FastSoyAdmin`](https://github.com/sleep1223/fast-soy-admin) is a production-ready, full-stack admin template. The frontend is built with Vue3, Vite7, TypeScript, Pinia, and UnoCSS; the backend is powered by FastAPI, Pydantic v2, and Tortoise ORM, with Redis for caching to accelerate API responses. The project comes with rich theme configurations, a complete RBAC permission system, automated file-based routing, and multi-language support. It is ideal as a starting scaffold for admin projects and a great resource for learning full-stack development best practices.
## Features
- **Full-Stack Tech Stack**: Backend with FastAPI + Pydantic v2 + Tortoise ORM; frontend with Vue3 + Vite7 + TypeScript + Pinia + UnoCSS — both using mainstream, modern technologies.
- **Complete Permission System**: Based on the RBAC model with strict separation of roles and permissions between frontend and backend. The backend performs secondary authorization at the API and button level, ensuring security and control.
- **Logging & Auditing**: Built-in request logging and operation log management for easy troubleshooting and audit trails.
- **Redis Cache Acceleration**: Integrated fastapi-cache2 + Redis to effectively improve API response speed.
- **Clear Project Structure**: Managed with pnpm monorepo; backend follows a layered architecture (Router → Controller → CRUD/Model), keeping the codebase clean and maintainable.
- **Strict Code Standards**: Frontend follows the [SoybeanJS specification](https://docs.soybeanjs.cn/zh/standard), with ESLint + oxlint + simple-git-hooks integration; backend uses [Ruff](https://docs.astral.sh/ruff/) + [Pyright](https://microsoft.github.io/pyright) to maintain consistent code style.
- **Full TypeScript Coverage**: Supports strict type checking to improve code maintainability and developer experience.
- **Rich Theme Configuration**: Built-in multiple theme options, deeply integrated with UnoCSS for easy UI customization.
- **Internationalization Support**: Built-in vue-i18n multi-language solution (Chinese / English), switch languages with one click.
- **Rich Pages & Components**: Built-in 403, 404, 500 error pages, integrated with ECharts, AntV, VChart and other visualization libraries, plus rich text editor, Markdown editor, and more.
- **Mobile Adaptation**: Responsive layout with full support for mobile access.
- **One-Click Docker Deployment**: Complete Docker Compose configuration (Nginx + FastAPI + Redis) — start the full stack with a single command.
## Related Links
- [Live Preview](https://fast-soy-admin.sleep0.de/)
- [Project Documentation](https://sleep1223.github.io/fast-soy-admin-docs/zh/)
- [Apifox API Documentation](https://apifox.com/apidoc/shared-7cd78102-46eb-4701-88b1-3b49c006504b)
- [GitHub Repository](https://github.com/sleep1223/fast-soy-admin)
- [SoybeanAdmin](https://gitee.com/honghuangdc/soybean-admin)
- [FastAPI](https://fastapi.tiangolo.com/)
- [Tortoise ORM](https://tortoise.github.io)
## Screenshots
## Quick Start
### Method 1: Docker Deployment (Recommended)
```bash
# Clone the project
git clone https://github.com/sleep1223/fast-soy-admin
cd fast-soy-admin
# Start all services
docker compose up -d
# View logs
docker compose logs -f # All services
docker compose logs -f app # FastAPI only
docker compose logs -f nginx # Nginx only
docker compose logs -f web # Frontend build only
```
Redeploy after updating code:
```bash
docker compose down && docker compose up -d
```
### Method 2: Local Development
**Requirements**
| Tool | Version |
| ------- | ---------- |
| Git | - |
| Python | >= 3.12 |
| Node.js | >= 20.0.0 |
| uv | ---------- |
| pnpm | ---------- |
**Installation & Startup**
```bash
# Clone the project
git clone https://github.com/sleep1223/fast-soy-admin
cd fast-soy-admin
# Backend dependencies
uv sync # or: pdm install / pip install -r requirements.txt
# Frontend dependencies (please use pnpm, as the project uses pnpm monorepo)
cd web && pnpm install
# Start backend (port 9999)
uv run python run.py
# Start frontend (port 9527, in a new terminal)
cd web && pnpm dev
```
**Build Frontend**
```bash
cd web && pnpm build
```
## TODO
- [x] Optimize response speed using Redis
- [x] Deploy using Docker
- [ ] Integrate FastCRUD
## Contributing
We welcome [Pull Requests](https://github.com/sleep1223/fast-soy-admin/pulls) and [Issues](https://github.com/sleep1223/fast-soy-admin/issues/new). Any form of contribution is greatly appreciated.
## Contributors
Thanks to all the developers who have contributed to this project.
## Star History
[](https://star-history.com/#sleep1223/fast-soy-admin&Date)
## License
This project is licensed under the [MIT © 2024](./LICENSE) license. Free to use and modify. For commercial use, please retain the author's copyright information. The author provides no warranty or liability for the software.
