AI-Web-Base

A minimal AI web full stack template.

---

这是一个最小化的AI全栈开发模板。支持docker，react shadcn ui vite fastapi fastmcp

技术栈

• 后端: Python 3.10+, FastAPI, sqlite3
• 前端: React, TypeScript, shadcn/ui, Tailwind CSS, Node.js 20.19.3+
• AI后端: Python 3.10+, OpenAI SDK
• 工具后端: Python 3.10+, FastMCP, MCP

快速开始

如果需要查看 Docker 启动方式，请参考 DOCKER_README.md。

克隆项目

git clone https://github.com/li-xiu-qi/AI-Web-Base.git

本地开发

• 后端快速启动
• 前端快速启动
• AI后端快速启动
• 工具后端快速启动

项目结构

ROOT/
├── backend/          # 主后端服务 (FastAPI)
├── AIbackend/        # AI服务后端 (OpenAI + FastMCP)
├── Toolsbackend/     # 工具服务后端 (MCP协议)
├── frontend/         # 前端应用 (React + TypeScript)
├── docs/            # 项目文档
├── docker-compose.yml # Docker编排配置
└── README.md        # 项目说明

系统架构

……待更新

API文档

……待更新

贡献指南

本项目通过 pre-commit 钩子统一执行代码格式化、静态检查与类型检查，并使用 pytest 作为测试框架。更多详情请参阅 CONTRIBUTING.md。

许可证

MIT license