KU

konsn666/unlimited-ocr-mac

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

36 stars 3 forks 품질 55 트렌드 16NOASSERTION

☸ 맥 (애플 실리콘) baidu/Unlimited-OCR 6.7B VLM의 적응. .cuda()→.to('mps') 패치 + 오토 캐스트 워크라운드 + MCP 서버. M4 Pro에 20s/document.

개요

上本地上通 baidu/Unlimited-OCR (6.7B VLM) - 的 OCR, O [bbox] 格式。 。这个仓库是社区一的 Mac :打 3 打 패치,和都令和上一一。 ./model dir,, ~/.cache/huggingface/hub/。装外置 SSD: 1. 下 下 下 下 下 🌐 文下式原原文下方 4. O O O O O O O O。 (~/.claude.json m目 .mcp.json): Open OpenAI Codex CLI (~/.codex/config.toml): O, AI的 AI 用: - ocr image(path) - O OCR, O JSON - ocr directory(path) - 理目ρ - model status() - 加

개요(AI 번역)

한국어 |中文


한국어

上本地 通 baidu/Unlimited-OCR (6.7B VLM) - O 접지 的 OCR, O [bbox] 格式。

** 方DA NVIDIA CUDA 12.9+**。官社区官的 Mac ::打 3 打,和都和上跡一鶏。

✨

인포메이션 |—||| 인포메이션 인포메이션 인포메이션 上 上 上 上 上 | 原 原 原 原 原 原 原 三** | 原原文 / 三文 / 三三三式 | ₢ 킹 인포메이션 주식회사 S S S

(M4 프로 48GB)

| |
|—||| 인포메이션 인포메이션 인포메이션 센터 인포메이션 | 인포메이션 | 文房具 (1024×1024, 13 行) | ~19s | 인포메이션

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

./model_dir,T ~/.cache/huggingface/hub/。 SSD SSD:

一行

웹 UI (짐):

**:

##################################################################################################################################

###########################################################################

################################################################################################################################################################################################################################################################

| 도호쿠 | 도호쿠 |—||| | 原 | 原原文件 (PDF )) | | O | O( O、 O) | | 上上 / 上 / 上 / 上 인포메이션 인포메이션

################################################################################################################################################################################################################################################################

  1. 下下下目言(T[T3]])
  2. 原原原文下方

web/.env]]

****。

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Unlimited OCR · Mac (Apple Silicon) 适配版

English | 中文


中文

在 Mac Apple Silicon (M1 / M2 / M3 / M4) 上本地跑通 baidu/Unlimited-OCR (6.7B VLM) — 带 grounding 的 OCR,直接输出 [bbox] 格式。

官方只支持 NVIDIA CUDA 12.9+。这个仓库是社区维护的 Mac 适配:打 3 个 patch,其它都和上游一致。

✨ 功能亮点

功能 说明
🔍 本地 OCR 6.7B VLM 模型完全本地运行,无需联网,隐私安全
🖥️ Web UI 浏览器直操作:上传 → 扫描 → 编辑 → 翻译 → 导出 Word
🌐 双语翻译 支持中/英/日/韩/法/德等 10+ 语言互译,原文+译文紧贴对照
📄 导出 Word 支持仅原文 / 仅译文 / 双语对照三种导出模式
✏️ 在线编辑 识别结果可直接点击修改,实时保存
🤖 MCP 服务 一键接入 Claude Code / Codex / 其他 AI 工具
⚡ 实时流式 SSE 逐行推送扫描结果,边扫边看

实测性能 (M4 Pro 48GB)

任务 耗时
模型加载(从 SSD 读 6.7GB) ~3s
简单图 (768×1024) ~9s
复杂文档 (1024×1024, 13 行) ~19s
多图批处理 ~20s/图

🚀 一键安装

git clone https://github.com/Konsn666/unlimited-ocr-mac.git
cd unlimited-ocr-mac
bash scripts/install.sh          # 安装 OCR 模型 (~5-10 分钟, 下载 6.7GB)
bash web/scripts/install_web.sh  # 安装 Web UI 依赖 (~1 分钟)

模型默认装到 ./model_dir,缓存走 ~/.cache/huggingface/hub/。装外置 SSD:

HF_HUB_CACHE="/Volumes/外置盘/Model/hub" bash scripts/install.sh

一键运行

Web UI (推荐):

bash web/scripts/start_web.sh
# 打开 http://localhost:8800

命令行:

# 单图
bash scripts/run.sh /path/to/your.png

# 多图批处理
bash scripts/run.sh --image_dir /path/to/images/ --output_dir ./out

# 高级参数
bash scripts/run.sh /path/to/image.png \
    --base_size 1024 --image_size 640 --max_length 8192 \
    --no_repeat_ngram_size 35 --ngram_window 128

🖥️ Web UI 使用指南

基本流程

上传 PDF/图片 → 点击「开始扫描」→ 实时查看识别结果 → 编辑 → 翻译 → 导出 Word

界面布局

区域 功能
左侧面板 原始文件预览(PDF 自动按页切换)
右侧面板 OCR 识别结果(可编辑、翻译)
顶部工具栏 上传 / 扫描 / 翻译语言选择 / 导出
底部状态栏 模型状态 / 设备信息

翻译功能

  1. 在顶部下拉框选择目标语言(如 → English)
  2. 点击 🌐 翻译 按钮
  3. 译文以紫色缩进样式紧跟在原文下方
  4. 再次点击可取消翻译

翻译 API 配置(编辑 web/.env):

# 支持任何 OpenAI 兼容的 API
TRANSLATE_API_BASE=https://api.openai.com/v1    # OpenAI
# TRANSLATE_API_BASE=https://api.deepseek.com/v1 # DeepSeek
# TRANSLATE_API_BASE=http://localhost:11434/v1    # 本地 Ollama

TRANSLATE_API_KEY=sk-your-api-key-here
TRANSLATE_MODEL=gpt-4o

💡 提示: 翻译是可选功能。不配置 API Key 仍可正常使用 OCR 识别和导出,只是无法翻译。

导出 Word

点击 📥 导出 Word 按钮后,可选择三种模式:

模式 说明
仅原文 只输出 OCR 识别的原始文字
仅译文 只输出翻译后的文字(需先翻译)
双语对照 一行原文、一行译文交替排列

作为 MCP 服务 (给 Claude Code / Codex / 其他 AI 工具调用)

bash scripts/mcp.sh    # 启动 stdio MCP server

注册到 Claude Code (~/.claude.json 或项目 .mcp.json):

{
  "mcpServers": {
    "unlimited-ocr": {
      "command": "python3",
      "args": ["/path/to/unlimited-ocr-mac/mcp_server/server.py"]
    }
  }
}

注册到 OpenAI Codex CLI (~/.codex/config.toml):

[mcp_servers.unlimited-ocr]
command = "python3"
args = ["/abs/path/to/unlimited-ocr-mac/mcp_server/server.py"]

启动后,你的 AI 工具就能调用:

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "unlimited-ocr": { "command": "python3", "args": ["/path/to/unlimited-ocr-mac/mcp_server/server.py"] } } }