## ๐ก Why FastapiAdmin?
| You Need | FastapiAdmin | Django Admin | Frontend-Only |
|----------|:-----------:|:-----------:|:-------------:|
| ๐ฏ **Ready-to-use** admin system | โ
| โ ๏ธ Limited | โ UI only |
| โก **FastAPI async** high-performance backend | โ
| โ Sync-first | โ No backend |
| ๐ **RBAC** menu/button/data level permissions | โ
| โ Basic | โ |
| ๐ค **Code generator** (table โ full CRUD) | โ
| โ | โ |
| ๐ฑ **Mobile** (H5 + Mini Program) included | โ
| โ | โ |
| ๐ณ **Docker** one-click deploy (Nginx + SSL) | โ
| โ | โ |
> ๐ Full comparison: [Why FastapiAdmin?](https://service.fastapiadmin.com/en/guide/why)
## ๐ช Live Demo
| | URL | Account |
|---|-----|---------|
| ๐ป Web | [service.fastapiadmin.com/web](https://service.fastapiadmin.com/web) | `admin` / `123456` |
| ๐ฑ Mobile | [service.fastapiadmin.com/app](https://service.fastapiadmin.com/app) | `admin` / `123456` |
| ๐ Official Docs | [service.fastapiadmin.com](https://service.fastapiadmin.com) | No login |
## ๐ 5-Minute Quick Start
```bash
# 1. Clone
git clone https://github.com/fastapiadmin/FastapiAdmin.git
# 2. Configure environments
cp backend/env/.env.dev.example backend/env/.env.dev
cp frontend/web/.env.development.example frontend/web/.env.development
# 3. Start backend (auto-creates tables + seed data on first run)
cd backend && uv sync && uv run main.py run --env=dev
# 4. Start frontend
cd ../frontend/web && pnpm install && pnpm run dev
# โ
Open http://127.0.0.1:5173, login with admin/123456
```
| Requirements | |
|-------------|------|
| Python โฅ 3.12 | Node.js โฅ 20 + pnpm |
| PostgreSQL 16 | Redis 6.x / 7.x |
## ๐ฆ Structure
```
FastapiAdmin/ # Monorepo full-stack project
โโ backend/ # FastAPI backend (Pydantic 2.0 + SQLAlchemy + Alembic)
โโ frontend/
โ โโโ web/ # Vue3 Web (Element Plus + TypeScript)
โ โโโ app/ # UniApp Mobile (H5 + Mini Program + App)
โ โโโ docs/ # VitePress documentation
โโ docker/ # Docker Compose deploy (Nginx + SSL)
โโ deploy.sh # One-click deploy script
โโ LICENSE # MIT
```
## ๐ Built-in Features
| Module | Capabilities |
|--------|-------------|
| ๐ Dashboard | Workbench, Analytics |
| โ๏ธ System | Users, Roles, Menus, Departments, Positions, Dicts, Config, Notices |
| ๐ Monitoring | Online users, Server, Cache |
| ๐ Tasks | Scheduled task management |
| ๐ Logs | Operation auditing |
| ๐งฐ Dev Tools | **Code Generator** (table โ full CRUD), Form Builder, API Docs |
| ๐ Files | Unified file management |
| ๐ค AI Agent | Agno-powered assistant |
## ๐ง Screenshots
| Login | Dashboard | Code Generator | AI Assistant |
| ----- | --------- | -------------- | ------------ |
|  |  |  |  |
## ๐ Documentation
- ๐ [Official Docs](https://service.fastapiadmin.com) โ Full guides, architecture, custom development
- ๐ Sub-project READMEs: [backend](backend/README.md) ยท [web](frontend/web/README.md) ยท [mobile](frontend/app/README.md) ยท [Docker](docker/README.md)
## ๐ค Contributing
Issues and PRs are welcome! See [Contributing Guide](https://service.fastapiadmin.com/en/about/contributing).
## ๐ฅ Community
| WeChat Group | Support |
| ------------ | ------- |
|  |  |
## ๐ฅ Contributors
