公開MLX変換は本当に動くか — 使えない変換を実測で見分ける方法Even models published on Hugging Face as MLX conversions can be broken — one…
匿名の公開いいねです。記事の保存・お気に入りではなく、Featured、Top 3、重要度、掲載順位には影響しません。仕組みとプライバシーAnonymous public likes are reactions, not saved articles or bookmarks. They do not affect Featured, Top 3, importance, or listing order.How it works and privacy
- Hugging Faceに「MLX変換済み」として公開されているモデルでも、ロード不能や全文字化けといった致命的な不具合を抱える例があり、著者がBaiduのOCRモデルを題材に既存変換2種を実測して問題を明らかにした。
- 重みファイルが生成できても正常動作するとは限らず、実測による検証が不可欠だと示している。
- Even models published on Hugging Face as MLX conversions can be broken — one failing to load and another producing garbled output — as the author discovered when benchmarking two existing conversions of Baidu's Unlimited-OCR (3.3B, MIT).
- The article argues that generating weight files does not guarantee a working model, and only empirical testing can confirm usability.
要約と収集メタデータをもとに生成した AI 解説本文です。元記事全文の転載・翻訳ではありません。This AI explainer is generated from the summaries and collected metadata, not from a reproduction or translation of the full source article.
Hugging Faceで「MLX変換済み」として公開されているモデルが、ダウンロードしてみると正常に動かない——そんな事例を、ローカルLLMを扱う技術ブログが実測レポートとして報告している。重みファイルが用意されているだけでは、モデルとして機能する保証にはならないという指摘だ。
MLXはApple Silicon向けに最適化された機械学習フレームワークで、Mac上でLLMや画像認識モデルを効率よく動かすために広く使われている。Hugging Faceには、PyTorchなどで学習された元モデルをMLX形式へ変換したものが数多く投稿されており、利用者はそれをダウンロードして手元で実行するのが一般的だ。ただし変換は誰でも投稿でき、動作検証まで済んでいるとは限らない。
今回題材になったのは、Baiduが公開したOCRモデル「Unlimited-OCR」(3.3B、MITライセンス)だ。著者は自身で変換を行う過程で、すでに公開されていた既存の変換2種を同じ評価セットで実測した。その結果、一方はそもそもロードできず、もう一方は出力が全文字化けだったという。しかも文字化けした方は、この系統の変換の中でダウンロード数が最多だったとされる。
Hugging Faceに「MLX変換済み」として公開されているモデルでも、ロード不能や全文字化けといった致命的な不具合を抱える例があり、著者がBaiduのOCRモデルを題材に既存変換2種を実測して問題を明らかにした。
著者は、これは特定の投稿者を批判するための記事ではないと断っている。強調されているのは、変換という作業には「重みファイルができた」状態と「モデルとして機能する」状態のあいだに距離があり、その距離は実際に動かして測る以外に埋めようがない、という点だ。ダウンロード数の多さが品質を保証しないことも、この事例は示している。
こうした不具合は、モデル構造の扱いやトークナイザ、量子化の設定など、変換工程のどこかで生じる可能性がある。特にOCRのようにテキスト出力の正確さが直接評価されるタスクでは、文字化けのような問題が一目でわかりやすい。裏を返せば、評価セットを用意して実測する習慣があれば、使えない変換を早い段階で見分けられるということでもある。公開されている変換を鵜呑みにせず、自分のユースケースで検証することの重要性を、この報告はあらためて浮き彫りにしている。
Anyone assembling local large language model pipelines on Apple hardware has likely learned to treat the "MLX converted" label on Hugging Face as a signal that a model is ready to run. A recent hands-on report from the Zenn community challenges that assumption, demonstrating that some models published under this label do not work in practice — one fails to load at all, and another produces nothing but garbled characters. For practitioners who depend on community conversions rather than converting weights themselves, it is a pointed reminder that a published file is not the same as a verified, functioning model.
The case study centers on Baidu's Unlimited-OCR, a 3.3-billion-parameter optical character recognition model released under the permissive MIT license. MLX is Apple's array and machine learning framework built for Apple Silicon, and the surrounding tooling — libraries such as mlx-lm and mlx-vlm — converts models from formats like PyTorch or safetensors into a representation that runs efficiently on Mac GPUs. Because that conversion is largely mechanical, it is tempting to assume the output faithfully reproduces the original.
The author set out to convert Unlimited-OCR independently and, in the process, benchmarked two conversions that were already publicly available, running each through the same evaluation set. The results were stark. One of the two existing conversions could not be loaded at all. The other loaded but returned completely garbled output, rendering it effectively useless for the OCR task it was meant to handle. One of these flawed conversions was, notably, the most-downloaded conversion in its lineage — a detail suggesting that download counts are a poor proxy for whether a model actually works.
Even models published on Hugging Face as MLX conversions can be broken — one failing to load and another producing garbled output — as the author discovered when benchmarking two existing conversions of Baidu's Unlimited-OCR (3.3B, MIT).
The report frames this as a technical observation rather than a criticism of the people who uploaded the conversions. Its central argument is that there is a real distance between "the weight files were generated" and "the model functions as a model," and that this gap can only be closed through empirical measurement. In other words, a successful export step tells you little about downstream behavior; only running the model against real inputs and inspecting the outputs can confirm usability.
There are technical reasons this class of failure is common with models like Unlimited-OCR. OCR and other vision-language systems are not monolithic — they typically combine a vision encoder, a projection layer, a language model, and a specific tokenizer or image processor. Conversion tooling tuned for text-only LLMs can mishandle these components, misalign weight tensors, or drop the preprocessing configuration a model needs. Garbled character output, in particular, frequently points to a tokenizer mismatch or an incorrect weight mapping, while a hard load failure often reflects unsupported layers or metadata that the
本ページの本文と要約は AI による自動生成です。日本語版と英語版は言語ごとに独立して生成されるため、表現や詳しさが異なる場合があります。正確性は元記事 (zenn.dev) をご確認ください。The body and summaries are AI-generated independently for each language, so wording and detail may differ. Verify accuracy at the original source (zenn.dev).




