
ocrs
Rust 原生 OCR,图片转文字,部署零依赖
ocrs 是一个用 Rust 编写的 OCR 库和命令行工具,目标是从图片中提取文字。它把机器学习模型推理封装成易用的 Rust API,同时提供 CLI 方便直接对图片文件做识别,适合嵌入到已有 Rust 服务或桌面工具中。相比依赖 Python 生态的 OCR 方案,ocrs 编译为原生二进制,启动快、部署简单,不引入 Python 运行时。项目采用 Rust 实现模型加载与推理,覆盖常见的文本检测与识别流程,支持对单张图片输出文字结果。对需要在边缘设备、CLI 批处理或 Rust 后端中集成 OCR 的开发者来说,它提供了比调用外部服务更轻量的选择。项目仍在成长阶段,星标约 1.9k,社区和文档还在完善中。
项目数据
使用教程
环境要求
- 已安装 Rust 和 Cargo 工具链
- 网络可访问 crates.io 以安装 ocrs-cli
- 首次运行时需联网自动下载模型
- 一张待识别的图片文件(如 PNG)
- 可选:需要读取系统剪贴板时,安装需启用 clipboard feature
安装与启动步骤
-
1准备 Rust 环境
ocrs CLI 需要 Rust 和 Cargo 才能安装。README 未给出 Rust 安装命令,请先按 Rust 官方方式安装好工具链并确认 cargo 可用。
-
2安装 ocrs CLI
用 Cargo 从 crates.io 全局安装 ocrs 命令行工具,--locked 表示按锁定依赖版本安装。
cargo install ocrs-cli --locked -
3安装剪贴板支持
可选步骤。如果希望直接从系统剪贴板读取图片,安装时加上 clipboard feature;否则跳过。
cargo install ocrs-cli --locked --features clipboard -
4识别图片文字
对指定图片文件运行 ocrs,终端会输出识别出的文字。把 image.png 换成你自己的图片路径。
ocrs image.png -
5从剪贴板识别
启用 clipboard feature 后,可直接读取剪贴板中的图片并输出文字,-c 是 --clipboard 的短选项。
ocrs --clipboard
如何确认成功
首次运行会自动下载模型并保存到 ~/.cache/ocrs,终端打印出图片中的文字内容即表示识别成功。
常见问题
Q:第一次运行很慢或卡在网络下载?
A:首次运行 ocrs 会自动下载所需模型并缓存到 ~/.cache/ocrs,需要联网等待下载完成,之后再运行会更快。
Q:ocrs 支持中文识别吗?
A:不支持。当前仅识别拉丁字母(如英文),更多语言支持在项目的 issue 中列为计划功能。
Q:怎么识别剪贴板里的图片?
A:安装时需加 --features clipboard,然后运行 ocrs --clipboard 或简写 ocrs -c 即可。
Q:识别准确率如何?
A:项目处于早期预览(early preview)阶段,README 明确提示错误可能比商业 OCR 引擎更多。
注意事项
- 项目状态为 early preview,效果尚不稳定,不建议直接用于对准确率要求高的生产场景。
- 目前只支持拉丁字母,中文等其它语言尚未支持。
- 底层使用 PyTorch 训练的模型,导出为 ONNX 后由 RTen 引擎执行推理。
- 模型不需要手动下载,首次运行会自动放到 ~/.cache/ocrs 目录。
核心亮点
- 纯 Rust 实现,编译为原生二进制,无需 Python 运行时,部署和启动开销小
- 同时提供库和 CLI,既能嵌入 Rust 项目,也能直接命令行批量识别图片
- 推理流程封装完整,模型加载与文本检测识别一体化,接入成本低
不足之处
- 模型与语言覆盖范围有限,非拉丁语系和复杂版式效果待验证
- 文档和示例相对精简,社区生态与预训练模型数量不及成熟 OCR 项目
适用场景
- Rust 后端服务中集成图片文字提取,避免引入 Python 依赖
- 命令行批量处理截图或扫描件,快速导出文本
- 边缘设备或桌面工具中做本地离线 OCR,保护数据隐私
替代项目
tesseract、paddleocr、easyocr
项目介绍
同类项目推荐
modlens
开源
给纯文本编码代理装上眼睛,粘贴图片即刻获得结构化视觉证据。
The first vision plugin for DeepSeek Harness, and the vision bridge for every text-o···
opencv
开源
开箱即用的视觉算法库,搞定图像视频处理与识别
Open Source Computer Vision Library
OpenCVTutorials
开源
中文 OpenCV 教程,从入门到实战,边看边跑代码
OpenCV-Python4.1 中文文档
DEIMv2
开源
用DINOv3做实时检测,又快又准,直接落地。
[DEIMv2] Real Time Object Detection Meets DINOv3