commit 96d9e6af5e1d2b6ebe7586f7552bc59125c89fbb
Author: huangzhuang_3rd <huangzhuang_3rd@tphai.com>
Date:   Mon Jun 1 18:30:47 2026 +0800

    v1.8.0: 模块化重构 + 后台登录认证

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..63b2478
--- /dev/null
+++ b/README.md
@@ -0,0 +1,71 @@
+# ParamHub - 参数百科 (Python版)
+
+> AI大模型与硬件参数速查平台
+
+## 功能特点
+
+- **模型数据库**: GPT-4、Llama、Claude等大模型参数规格
+- **GPU数据库**: H100、A100、RTX 4090等GPU详细规格
+- **CPU数据库**: AMD EPYC、Intel Xeon等服务器CPU参数
+- **实用工具**: 显存计算器、GPU推荐
+- **对比工具**: 多维度对比模型/GPU/CPU
+- **知识库**: 参数解释、选型指南
+
+## 技术栈
+
+- Python 3 + Flask
+- Tailwind CSS (CDN)
+- RemixIcon
+
+## 快速开始
+
+```bash
+# 安装依赖
+pip install -r requirements.txt
+
+# 运行服务
+python app.py
+
+# 访问地址
+http://localhost:19010
+```
+
+## 目录结构
+
+```
+param-hub-python/
+├── app.py              # Flask主程序
+├── templates/          # HTML页面
+│   ├── index.html      # 首页
+│   ├── models.html     # 模型数据库
+│   ├── gpus.html       # GPU数据库
+│   ├── cpus.html       # CPU数据库
+│   ├── tools.html      # 实用工具
+│   ├── compare.html    # 对比工具
+│   └── knowledge.html  # 知识库
+├── data/               # 数据文件
+│   ├── models.json     # 模型数据
+│   ├── gpus.json       # GPU数据
+│   └── cpus.json       # CPU数据
+├── requirements.txt    # Python依赖
+├── run.sh              # 启动脚本
+└── README.md           # 说明文档
+```
+
+## API接口
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/models` | GET | 获取模型列表 |
+| `/api/models/<id>` | GET | 获取模型详情 |
+| `/api/gpus` | GET | 获取GPU列表 |
+| `/api/gpus/<id>` | GET | 获取GPU详情 |
+| `/api/cpus` | GET | 获取CPU列表 |
+| `/api/cpus/<id>` | GET | 获取CPU详情 |
+| `/api/search` | GET | 全局搜索 |
+| `/api/calculate/vram` | GET | 显存计算 |
+| `/api/stats` | GET | 统计数据 |
+
+## 版本
+
+- v0.1.0 - 初始版本
\ No newline at end of file