オープンソース OCR · 0.8B パラメータ

Xiaomi-OCR-0:文書画像を構造化データに変換

文書解析と OCR 理解のための Xiaomi のコンパクトなビジョン言語モデルを探索します。オンライン デモ、モデルの重み、技術レポート、実践的なローカル導入ガイドを 1 か所で見つけられます。

独立したリソース ガイド。デモは外部の Hugging Face Space で実行されます。このページでは文書のアップロードや処理は行われません。

チェックしたソース:

Xiaomi-OCR-0 に入り、構造化テキスト、テーブル、および抽出されたフィールドになるドキュメント ページの図。
文書理解のオリジナルの概念図。モデルによって生成された結果ではありません。

Xiaomi-OCR-0をオンラインで試す

新しいタブで、Hugging Face の loongwayX デモを開きます。これは、プロジェクトの情報ページとは異なる、別個のホストされたワークベンチです。

  1. 01

    タスクとサンプルを選択してください

    提供された例または機密性のない文書画像から始めます。外部ワークベンチでドキュメントの解析、フィールド抽出、またはページに関する質問を選択します。

  2. 02

    文章だけでなく構造もチェックする

    読み取り順序、表のセル、数式を元のページと比較します。フィールド抽出の場合は、戻り値が実際にドキュメント内に表示されることを確認してください。

オンにすると外部ワークベンチ ページにアクセス可能になります . これはページの可用性のみをチェックし、推論の成功はチェックしません。スペースがスリープ状態になったり、リクエストをキューに入れたり、失敗した場合は、ローカルのデモ手順を使用してください。 ローカル展開

この 0.8B OCR モデルでは何ができるのでしょうか?

Xiaomi-OCR-0 は文書画像の読み取りと理解に特化しています。プロジェクトは、モデルをページ準備および出力アセンブリ ツールと組み合わせます。

  1. 01

    文書の解析

    文書ページからテキストと読み上げ順序を復元します。リポジトリのツールは、ページ全体の解析と、通常の印刷レイアウト用の領域ベースのパイプラインをサポートしています。

  2. 02

    表と式

    表の構造と数式を認識します。提供されたワークフローでは、OTSL テーブル出力は Markdown 内で HTML に変換されます。数式は LaTeX を使用します。

  3. 03

    重要な情報の抽出

    日付や合計などの特定のドキュメントフィールドを要求し、KIE ワークフローを通じて構造化された JSON を受け取ります。抽出された値を下流で使用する前に検証します。

  4. 04

    文書による質疑応答

    表示されているページに基づいて質問してください。 OCR に重点を置いた VQA は、忠実な転写とは別のタスクであり、誤った解釈が生じる可能性があります。

画像または PDF からページの準備、オプションの領域検出、Xiaomi-OCR-0 推論、Markdown または JSON への後処理を経たワークフロー。
ワークフロー図: 周囲のツールがページを準備し、出力を組み立てます。領域解析によりレイアウト検出が追加されます。この図は推論結果やベンチマークではありません。

モデルと完全なアプリケーションには異なる責任があります。 PDF ラスタライズ、オプションのレイアウト検出、クロップ順序付け、テーブル変換は、周囲のパイプラインに属します。ベア モデルの呼び出しは、同じ組み立てられたドキュメントを返すと想定すべきではありません。

重みをダウンロードしてソースを検査する

元のチェックポイントを参照として使用します。ダウンロードする前に、各コミュニティ変換のランタイム、ファイル、ライセンス通知を確認してください。

オリジナルの重みとコード

公式の Hugging Face リポジトリには、チェックポイントとモデル カードが含まれています。 GitHub は、デモ、前処理、評価ツールを提供します。このリリースには Apache 2.0 がリストされています。再配布する場合は、ライセンスと該当する通知を保持してください。

コミュニティ GGUF とオラマ

GGUF 変換はコミュニティの成果物です。画像推論には、互換性のあるビジョン プロジェクターも必要です。 Ollama のサポートは実験的であり、変換結果は元のモデルのベンチマーク スコアには含まれません。

Xiaomi-OCR-0をローカルで実行する

主要なルート: Linux、互換性のある NVIDIA GPU および vLLM。以下のコマンドは自分のマシン上で実行され、コピー可能なチュートリアルの例として提供されています。

リポジトリには Python 3.10 以降が必要です。ハードウェアおよび Qwen3_5ForConditionalGeneration アーキテクチャと互換性のある Python バージョン、CUDA/PyTorch ビルド、および vLLM リリースを選択します。ドライバーの要件については、リンクされた vLLM インストール ガイドに従ってください。 0.8B パラメータ数だけでは VRAM の合計使用量を指定するものではありません。画像の解像度、コンテキスト、同時実行性も重要です。

1. 推論環境のクローンを作成して準備する

git clone https://github.com/xiaomi-research/Xiaomi-OCR-0.git
cd Xiaomi-OCR-0
python3 -m venv .venv-inference
source .venv-inference/bin/activate
python -m pip install --upgrade pip
python -m pip install vllm

2.同じ端末でvLLMを起動します

vllm serve SeerRay-Lab/Xiaomi-OCR-0 \
  --host 127.0.0.1 --port 8000 --max-model-len 16384

コマンドは、プロジェクトのローカル デモ手順で使用されるチェックポイント識別子である SeerRay-Lab/Xiaomi-OCR-0 を保持します。公式モデルページは xiaomi-research の下で解決されるようになりました。モデルがロードされるまで待ち、サーバーを 127.0.0.1:8000 で実行し続けます。

3. 2 番目の端末を開いてデモを開始します

cd Xiaomi-OCR-0
python3 -m venv .venv-demo
source .venv-demo/bin/activate
python -m pip install -r requirements.txt
python demo/server.py --port 8787

2 番目のターミナルで、コマンドを実行する前に、複製されたリポジトリを含む親ディレクトリに移動します。次に、ブラウザで http://127.0.0.1:8787 を開きます。ページ全体モードで提供されたサンプルから始めます。別個のデモ環境では、その依存関係が推論ランタイムから切り離されます。

代替案: 実験的な Ollama

Qwen3.5 互換の Ollama をインストールし、ローカル サービスを実行し続けます。コミュニティ BF16 パッケージは約 1.8 GB で、ビジョン プロジェクターが含まれています。これらの Linux シェル コマンドは、プロジェクトのデモ前処理を使用します。モデルのプルだけでは OCR ワークフローを構成しません。

ローカル デモを Ollama に接続する

ollama pull longwayxu/xiaomi-ocr-0:bf16

# Run from the cloned Xiaomi-OCR-0 directory
python3 -m venv .venv-demo
source .venv-demo/bin/activate
python -m pip install -r requirements.txt
export XIAOMI_OCR_BACKEND=ollama
export XIAOMI_OCR_MODEL=longwayxu/xiaomi-ocr-0:bf16
export XIAOMI_OCR_LOCAL_URL=http://127.0.0.1:11434/v1
python demo/server.py --port 8787

オプション: 領域解析

通常の印刷ページの場合、領域モードには PaddlePaddle、PaddleX、PP-DocLayoutV3 が追加されます。まず公式の手順に従って互換性のある PaddlePaddle ビルドをインストールし、次にデモ環境でコマンドを実行します。レイアウトの重みは初回使用時にダウンロードされます。実行中のデモを再起動する前に停止してください。シーン テキスト、手書き、または不規則なレイアウトの場合は、ページ全体モードから始めます。

レイアウトの依存関係を追加し、デモを再開します

# In the Demo environment, after installing a compatible PaddlePaddle build
python -m pip install -r requirements-paddlex.txt
export XIAOMI_OCR_LAYOUT_DEVICE=cpu
python demo/server.py --port 8787

これらの例は、公開されている手順に対してチェックされており、ここでは GPU デプロイメントとして実行されていません。ローカルの精度、スループット、またはハードウェア メモリの結果は保証されません。モデルの読み込み、アーキテクチャのサポート、またはレイアウトの依存関係が失敗する場合は、プロジェクトのインストール ガイドを参照してください。

公開されている OCR モデルの比較

発行者の比較表から選択した行。これらは報告された結果であり、この Web サイトによって実行されたテストや現在の OCR モデルの完全なランキングではありません。

発行者が報告した文書解析 全体のスコア · ↑ 高いほど優れています
モデルパラメータOmniDocBench v1.6 ↑Real5-OmniDocBench ↑Wild-OmniDocBench ↑
Xiaomi-OCR-00.8B96.8395.2487.94
PaddleOCR-VL-1.60.9B96.3393.1987.36
GLM-OCR0.9B95.2290.3285.08
MinerU2.5-Pro1.2B95.7588.9487.33
OvisOCR20.8B96.5892.2987.91

Xiaomi-OCR-0 の 3 つの解析スコアは、レイアウト検出と領域推論を含む 2 段階のパイプラインを使用します。これらは、単一のページ全体のモデル呼び出しのスコアとして表示されるべきではありません。前処理とスコアリングの設定については、評価パイプラインを参照してください。

同じベンチマークとバージョン内の結果を比較します。選択したテーブルでは、レイテンシ、展開コスト、または GGUF/Ollama の精度が確立されていません。モデルを選択する前に、独自のページを使用して、読み取り順序、表、数式、およびフィールド抽出を評価します。

チェックしたソース:

Xiaomi-OCR-0 の質問

出典と詳細情報

現在の手順については、元のモデル カード、レポート、リポジトリを使用してください。このページには、日付付きの参照スナップショットが記録されます。ランタイムの互換性と外部デモの利用可能性は変更される可能性があります。