# ocrd

**Repository Path**: taj5/ocrd

## Basic Information

- **Project Name**: ocrd
- **Description**: 车厢集装箱识别服务
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-24
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

以下是为您的OCR项目生成的符合规范的README.md文件：


# OCRD Service: 列车车厢识别系统

基于MiniCPMV模型微调的OCR服务，专注于列车车厢编号和类型的高精度识别。
支持超面阵相机和线阵相机采集的图像输入。


## 目录
- [特性](#特性)
- [环境要求](#环境要求)
- [安装指南](#安装指南)
- [服务配置](#服务配置)
- [模型下载](#模型下载)
- [使用方法](#使用方法)
- [维护与监控](#维护与监控)
- [技术支持](#技术支持)


## 特性
- 基于MiniCPMV大型语言模型微调
- 支持多种车厢编号和类型的自动识别
- 提供RESTful API接口，便于集成
- 支持GPU加速（CUDA）
- 自动重启机制，确保服务高可用性
- 支持超面阵相机和线阵相机采集的图像输入


## 环境要求
- 操作系统：Linux (推荐Ubuntu 20.04+)
- Python版本：3.8+
- 硬件：支持CUDA的GPU（推荐NVIDIA RTX系列）
- 依赖：
  ```bash
  aiofiles>=24.1.0
  fastapi>=0.115.8
  numpy>=1.26.4
  torch==2.6.0
  torchvision==0.21.0
  opencv-python>=4.11.0.86
  ```


## 安装指南

### 1. 创建并激活conda环境
```bash
conda create -n ocrd python=3.10
conda activate ocrd
```

### 2. 构建项目
```bash
python -m build
```

### 3. 安装项目
```bash
pip install dist/ocrd-0.0.1-py3-none-any.whl
```


## 服务配置

### 1. 复制服务配置文件
```bash
sudo cp ocrd.service /etc/systemd/system/
```

### 2. 重载systemd并启用服务
```bash
sudo systemctl daemon-reload  # 重新加载服务配置
sudo systemctl enable ocrd.service  # 启用开机自启动
sudo systemctl start ocrd.service  # 启动服务
sudo systemctl status ocrd.service  # 检查服务状态
```

### 服务配置详情 (`ocrd.service`)
```ini
[Unit]
Description=Uvicorn instance to serve ocr app
After=network.target

[Service]
User=root
Group=root
Environment="CUDA_VISIBLE_DEVICES=0"
Environment="OCRD_LOG_PATH=/root/ocrd/ocrd.log"
Environment="OCRD_DATA_PATH=/root/ocrd/storage"
Environment="OCRD_BIG_MODEL_PATH=/root/ocrd/ocr_model"
ExecStart=/root/miniconda3/envs/SmartCarriageScan/bin/ocrd
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
```


## 模型下载

### 方法一：使用ModelScope CLI
```bash
pip install modelscope
modelscope login --token f89e9213-18a8-4d2f-a06b-62f399eee1cb
modelscope download --model ZMDS/train_ocr
```

### 方法二：使用Git LFS
```bash
git lfs install
git clone https://oauth2:BUdLrEq7wDsa6WszzCoS@www.modelscope.cn/ZMDS/train_ocr.git
```


## 使用方法

### API调用示例
```python
import requests

url = "http://localhost:8000/carriage_ocr/"
files = {"image": open("carriage.jpg", "rb")}

response = requests.post(url, files=files)
print(response.json())
```

### 服务管理命令
```bash
sudo systemctl restart ocrd.service  # 重启服务
sudo systemctl stop ocrd.service    # 停止服务
sudo journalctl -u ocrd.service -f  # 查看服务日志
```


## 维护与监控

### 查看服务状态
```bash
sudo systemctl status ocrd.service
```

### 查看实时日志
```bash
sudo journalctl -u ocrd.service -f
```

### 检查GPU使用情况
```bash
nvidia-smi
```


## 技术支持
- 问题反馈：请提交issue至项目仓库
- 联系邮箱：support@example.com
- 版本更新：定期检查项目仓库获取最新版本


## 贡献
欢迎提交Pull Request改进项目！请确保遵循项目的代码规范和贡献指南。


**© 2025 OCRD Service 团队. 保留所有权利.**