{"id":48540793,"url":"https://github.com/sleep1223/fast-soy-admin","last_synced_at":"2026-04-08T04:03:14.174Z","repository":{"id":240268677,"uuid":"802120148","full_name":"sleep1223/fast-soy-admin","owner":"sleep1223","description":"基于 FastAPI+Vue3+Naive UI 的现代化轻量管理平台。 A modern Management Platform based on FastAPI+Vue3+Naive UI.","archived":false,"fork":false,"pushed_at":"2026-03-26T01:20:30.000Z","size":1136,"stargazers_count":295,"open_issues_count":3,"forks_count":78,"subscribers_count":6,"default_branch":"dev","last_synced_at":"2026-03-26T11:58:22.058Z","etag":null,"topics":["admin","admin-template","fastapi","fastapi-admin","naive-ui","pinia","pydantic","python","tortoise-orm","typescript","unocss","vite5","vue","vue-admin","vue3"],"latest_commit_sha":null,"homepage":"https://fast-soy-admin2.sleep0.de/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sleep1223.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-17T14:59:48.000Z","updated_at":"2026-03-26T04:28:11.000Z","dependencies_parsed_at":"2024-05-21T11:07:26.131Z","dependency_job_id":"bfa9468e-a188-4e81-84e9-dc84886058c9","html_url":"https://github.com/sleep1223/fast-soy-admin","commit_stats":null,"previous_names":["sleep1223/fast-soy-admin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sleep1223/fast-soy-admin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleep1223%2Ffast-soy-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleep1223%2Ffast-soy-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleep1223%2Ffast-soy-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleep1223%2Ffast-soy-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sleep1223","download_url":"https://codeload.github.com/sleep1223/fast-soy-admin/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sleep1223%2Ffast-soy-admin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31539232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","admin-template","fastapi","fastapi-admin","naive-ui","pinia","pydantic","python","tortoise-orm","typescript","unocss","vite5","vue","vue-admin","vue3"],"created_at":"2026-04-08T04:03:03.602Z","updated_at":"2026-04-08T04:03:14.168Z","avatar_url":"https://github.com/sleep1223.png","language":"TypeScript","readme":"\u003c!-- markdownlint-disable MD033 MD041 --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/sleep1223/\"\u003e\u003cimg src=\"web/public/favicon.svg\" width=\"200\" height=\"200\" alt=\"github\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n# FastSoyAdmin\n\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable-next-line MD036 --\u003e\n\n[![license](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)\n[![github stars](https://img.shields.io/github/stars/sleep1223/fast-soy-admin)](https://github.com/sleep1223/fast-soy-admin)\n[![github forks](https://img.shields.io/github/forks/sleep1223/fast-soy-admin)](https://github.com/sleep1223/fast-soy-admin)\n![python](https://img.shields.io/badge/python-3.12+-blue?logo=python\u0026logoColor=edb641)\n![FastAPI](https://img.shields.io/badge/FastAPI-005571?logo=python\u0026logoColor=edb641)\n\n![Pydantic](https://img.shields.io/badge/Pydantic_v2-005571?logo=pydantic\u0026logoColor=edb641)\n![uv](https://img.shields.io/badge/uv-managed-blueviolet)\n[![pyright](https://img.shields.io/badge/types-pyright-797952.svg?logo=python\u0026logoColor=edb641)](https://github.com/Microsoft/pyright)\n[![ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\n[![DeepWiki](https://img.shields.io/badge/DeepWiki-sleep1223%2Ffast--soy--admin-blue?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzIiIGhlaWdodD0iMzIiIHZpZXdCb3g9IjAgMCAzMiAzMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjMyIiBoZWlnaHQ9IjMyIiByeD0iOCIgZmlsbD0iIzFFOTBGRiIvPgo8cGF0aCBkPSJNOCAxMEgxMlYyMkg4VjEwWiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTE1IDEwSDE5VjIySDE1VjEwWiIgZmlsbD0id2hpdGUiIG9wYWNpdHk9IjAuNyIvPgo8cGF0aCBkPSJNMjIgMTBIMjZWMjJIMjJWMTBaIiBmaWxsPSJ3aGl0ZSIgb3BhY2l0eT0iMC40Ii8+Cjwvc3ZnPg==)](https://deepwiki.com/sleep1223/fast-soy-admin)\n\n\u003cspan\u003eEnglish | \u003ca href=\"./README.md\"\u003e中文\u003c/a\u003e\u003c/span\u003e\n\n\u003c/div\u003e\n\n\u003e [!NOTE]\n\u003e If `FastSoyAdmin` is helpful to you, please give us a ⭐️ on GitHub. Your support means the world to us!\n\n## Introduction\n\n[`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.\n\n## Features\n\n- **Full-Stack Tech Stack**: Backend with FastAPI + Pydantic v2 + Tortoise ORM; frontend with Vue3 + Vite7 + TypeScript + Pinia + UnoCSS — both using mainstream, modern technologies.\n- **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.\n- **Logging \u0026 Auditing**: Built-in request logging and operation log management for easy troubleshooting and audit trails.\n- **Redis Cache Acceleration**: Integrated fastapi-cache2 + Redis to effectively improve API response speed.\n- **Clear Project Structure**: Managed with pnpm monorepo; backend follows a layered architecture (Router → Controller → CRUD/Model), keeping the codebase clean and maintainable.\n- **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.\n- **Full TypeScript Coverage**: Supports strict type checking to improve code maintainability and developer experience.\n- **Rich Theme Configuration**: Built-in multiple theme options, deeply integrated with UnoCSS for easy UI customization.\n- **Internationalization Support**: Built-in vue-i18n multi-language solution (Chinese / English), switch languages with one click.\n- **Rich Pages \u0026 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.\n- **Mobile Adaptation**: Responsive layout with full support for mobile access.\n- **One-Click Docker Deployment**: Complete Docker Compose configuration (Nginx + FastAPI + Redis) — start the full stack with a single command.\n\n## Related Links\n\n- [Live Preview](https://fast-soy-admin.sleep0.de/)\n- [Project Documentation](https://sleep1223.github.io/fast-soy-admin-docs/zh/)\n- [Apifox API Documentation](https://apifox.com/apidoc/shared-7cd78102-46eb-4701-88b1-3b49c006504b)\n- [GitHub Repository](https://github.com/sleep1223/fast-soy-admin)\n- [SoybeanAdmin](https://gitee.com/honghuangdc/soybean-admin)\n- [FastAPI](https://fastapi.tiangolo.com/)\n- [Tortoise ORM](https://tortoise.github.io)\n\n## Screenshots\n\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-01.png)\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-02.png)\n\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-04.png)\n\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-06.png)\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-07.png)\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-08.png)\n\n![](https://raw.githubusercontent.com/sleep1223/fast-soy-admin-docs/51832d41f1d951bd9d61a9bcfdf137deb81fd3c5/src/assets/QQ%E6%88%AA%E5%9B%BE20240517223056.jpg)\n![](https://raw.githubusercontent.com/sleep1223/fast-soy-admin-docs/51832d41f1d951bd9d61a9bcfdf137deb81fd3c5/src/assets/QQ%E6%88%AA%E5%9B%BE20240517223123.jpg)\n\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-09.png)\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-10.png)\n![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-mobile.png)\n\n## Quick Start\n\n### Method 1: Docker Deployment (Recommended)\n\n```bash\n# Clone the project\ngit clone https://github.com/sleep1223/fast-soy-admin\ncd fast-soy-admin\n\n# Start all services\ndocker compose up -d\n\n# View logs\ndocker compose logs -f        # All services\ndocker compose logs -f app    # FastAPI only\ndocker compose logs -f nginx  # Nginx only\ndocker compose logs -f web    # Frontend build only\n```\n\nRedeploy after updating code:\n\n```bash\ndocker compose down \u0026\u0026 docker compose up -d\n```\n\n### Method 2: Local Development\n\n**Requirements**\n\n| Tool    | Version    |\n| ------- | ---------- |\n| Git     | -          |\n| Python  | \u003e= 3.12    |\n| Node.js | \u003e= 20.0.0  |\n| uv      | ---------- |\n| pnpm    | ---------- |\n\n**Installation \u0026 Startup**\n\n```bash\n# Clone the project\ngit clone https://github.com/sleep1223/fast-soy-admin\ncd fast-soy-admin\n\n# Backend dependencies\nuv sync  # or: pdm install / pip install -r requirements.txt\n\n# Frontend dependencies (please use pnpm, as the project uses pnpm monorepo)\ncd web \u0026\u0026 pnpm install\n\n# Start backend (port 9999)\nuv run python run.py\n\n# Start frontend (port 9527, in a new terminal)\ncd web \u0026\u0026 pnpm dev\n```\n\n**Build Frontend**\n\n```bash\ncd web \u0026\u0026 pnpm build\n```\n\n## TODO\n\n- [x] Optimize response speed using Redis\n- [x] Deploy using Docker\n- [ ] Integrate FastCRUD\n\n## Contributing\n\nWe 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.\n\n## Contributors\n\nThanks to all the developers who have contributed to this project.\n\n\u003ca href=\"https://github.com/mizhexiaoxiao\"\u003e\n    \u003cimg src=\"https://github.com/mizhexiaoxiao.png?size=120\" width=\"64\" height=\"64\" style=\"border-radius:50%;\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/soybeanjs.png\"\u003e\n    \u003cimg src=\"https://github.com/soybeanjs.png?size=120\" width=\"64\" height=\"64\" style=\"border-radius:50%;\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/sleep1223/fast-soy-admin/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=sleep1223/fast-soy-admin\" /\u003e\n\u003c/a\u003e\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=sleep1223/fast-soy-admin\u0026type=Date)](https://star-history.com/#sleep1223/fast-soy-admin\u0026Date)\n\n## License\n\nThis 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.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsleep1223%2Ffast-soy-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsleep1223%2Ffast-soy-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsleep1223%2Ffast-soy-admin/lists"}