# 胸片识别

**Repository Path**: mxh0123/chest-x-ray-recognition

## Basic Information

- **Project Name**: 胸片识别
- **Description**: 基于yolo的胸片识别网站
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-30
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TorchXRayVision Local Web Demo

本项目是一个本地单机胸片识别网站：选择一张或多张 PNG/JPG/JPEG 胸片图片，点击识别，输出 TorchXRayVision 病灶概率表和 top-1 热力图。

> 仅供研究和软件开发演示，不用于诊断或临床决策。

## 环境要求

当前机器默认 `python` 是 Python 2.7，另有 Python 3.14。PyTorch/TorchXRayVision 不建议使用这两个版本，请安装 Python 3.10 或 3.11 后再创建虚拟环境。

Windows 示例：

```powershell
cd D:\yolo\chest-x-ray
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt
```

如果只安装了 Python 3.10，请把 `py -3.11` 改成 `py -3.10`。

## 、本地权重

权重文件已保存在\models\torchxrayvision目录：

```powershell
python scripts\download_weights.py
```

权重会保存到：

```text
models\torchxrayvision
```

网站运行时固定从这个目录加载权重。缺少权重时，服务会报错并提示先运行下载脚本。

## 启动网站

双击根目录的 `start.bat`，或在命令行运行：

```powershell
.\start.bat
```

脚本会检查虚拟环境和本地权重，启动后会自动打开浏览器。

停止服务可以双击根目录的 `stop.bat`，或在命令行运行：

```powershell
.\stop.bat
```

也可以手动启动：

```powershell
uvicorn app.main:app --host 127.0.0.1 --port 8000
```

浏览器打开：

```text
http://127.0.0.1:8000
```

健康检查：

```text
http://127.0.0.1:8000/api/health
```

## 支持格式

- PNG
- JPG
- JPEG

一次最多支持 12 张图片，单张最大 16MB。

不支持 DICOM、登录、数据库、历史记录或生产部署配置。