FreeToken 753bモデル:セットアップガイドとMoEチューニングのヒント - ベンチマーク

FreeToken 753bモデル:セットアップガイドとMoEチューニングのヒント

FreeTokenがローカル環境で753BのGLM-5.2を提供する仕組みを解説します。セットアップ、メモリページング、MoEキャッシュ、ベンチマーク、実践的なチューニング方法を取り上げます。

2026-08-25
FreeTokenチーム
クイックガイド
  • FreeToken 753bモデルとは、エッジネイティブなMoEエンジンを通じてGLM-5.2をローカルで提供する仕組みを指します。
  • 中核となる方法:GPU上にアクティブな処理を配置し、非アクティブなエキスパートをホストメモリ経由でページングします。
  • 推奨セットアップ:Linux x86-64、NVIDIA GPU、R580以降のドライバー、CUDA 13を使用します。
  • 最大の利点:データセンター用GPUクラスターを必要とせず、プライベートかつ低レイテンシーな推論を実行できます。
  • 主な制限:大規模なMoEモデルでは、依然として大量のホストメモリと互換性のあるハードウェアビルドが必要です。

FreeToken 753bモデルの概要

FreeTokenは、非常に大規模なオープンウェイトのMixture-of-Expertsモデルを個人のマシンで実用的に動作させるために設計された、エッジネイティブなサービングエンジンです。重要なのは、FreeToken自体が753Bモデルではないという点です。FreeTokenは、約7,530億パラメーターを持つと説明されているモデル GLM-5.2 を、1台のワークステーションGPU上で提供するランタイムです。

このシステムは、コンピューター全体を柔軟な推論プラットフォームとして扱います。すべてのモデルテンソルをVRAMに保持する前提ではなく、GPUメモリ、CPUメモリ、ホストストレージ、PCIe帯域幅、CPUの実行能力を連携させます。

動画のハイライト:

  • FreeTokenは、1台のワークステーションGPU上で、約400億のアクティブパラメーターを持つGLM-5.2を提供します。
  • ランタイムは、ポート1919でOpenAI互換およびAnthropic互換のエンドポイントを公開します。
  • Mixture-of-Expertsのスパース性により、各トークンに必要な計算量を削減します。
  • 共有キャッシュとホストメモリページングシステムにより、デコード時のキャッシュミスを減らします。

MoEモデルでは、総パラメーター数が、個々のトークンで使用されるパラメーター数を大きく上回る場合があります。たとえばDeepSeek-V4-Flashは、43層にわたって256個のエキスパートのうち6個を各トークンにルーティングします。つまり、1つのトークン計算には約13Bパラメーターが参加し、非アクティブなエキスパートはより大きなモデルプール内で利用可能な状態に保たれます。

概念意味重要な理由
総パラメーター数非アクティブなエキスパートを含むモデル全体の容量ストレージとホストメモリの要件を決定する
アクティブパラメーター現在のトークンに対して選択されたエキスパート計算負荷とトークン速度に影響する
エキスパートプール利用可能なすべてのMoEエキスパートルーティングが変わったときに保存・取得する必要がある
ホストページング非アクティブなエキスパートをシステムメモリ経由で移動することVRAM容量を超える大規模モデルの実行を可能にする
統合プラットフォームGPU、CPU、メモリ、インターコネクトが連携して動作する環境利用可能なハードウェアに合わせて実行を最適化する
重要な区別

753Bというパラメーター数は、すべてのトークンで密な753B規模の計算を行うことを意味しません。FreeTokenは、MoEのスパース性、適応的な配置、メモリページングを活用して、このワークロードを扱いやすくしています。

ハードウェアとインストールのセットアップ

FreeTokenは、汎用的なCPUのみのデプロイではなく、互換性のあるNVIDIAシステムを対象としています。ドキュメントで示されているコマンドラインの対象環境は、NVIDIA GPU、R580以降のドライバー、CUDA 13を備えたLinux x86-64です。また、FlashMLを通じて、WindowsとLinux向けのワンクリックデスクトップアプリも利用できます。

PyPIパッケージはfreetokenとして公開されており、参照されているリリースはバージョン0.1.2です。一般的なアクセラレーション対応インストールでは、次のコマンドを使用します。

uv pip install "freetoken[accel]"

実際に得られる性能は、GPUの世代、ドライバー、メモリ容量、PCIeリンク、ホストメモリ帯域幅、モデル形式、そして使用する構成向けのNVFP4またはMXFP4ビルドが利用できるかどうかによって異なります。

セットアップ項目ドキュメント上の要件実際の確認事項
オペレーティングシステムCLIはLinux x86-64、デスクトップアプリはWindowsとLinuxインストール前にアーキテクチャを確認する
GPUNVIDIA GPUドライバーがカードを認識していることを確認する
ドライバーR580以降nvidia-smiで確認する
CUDACUDA 13が対象ランタイムとアクセラレーターのビルドを一致させる
パッケージPyPIのfreetoken[accel]分離された環境内にインストールする
APIポートポート 1919ローカルサービング用にポートを確保する
1

NVIDIA環境を確認する

GPUが認識されていること、ドライバーがR580以降の要件を満たしていること、CUDAスタックが使用するFreeTokenビルドと互換性があることを確認します。モデルを選択する前に、利用可能なVRAMとシステムRAMを記録してください。

2

アクセラレーション対応パッケージをインストールする

分離されたPython環境を作成し、使用するワークフローでサポートされているパッケージマネージャーを使ってfreetoken[accel]をインストールします。トラブルシューティングを簡単にするため、他の推論エンジンとは環境を分けてください。

3

システム帯域幅を測定する

ft bench bwを実行して、PCIe転送帯域幅とホストメモリ帯域幅の関係をプロファイルします。FreeTokenはこの測定結果を使って、キャッシュミスをGPUへの転送とCPU実行の間でどのように分担するかを決定します。

4

互換性のあるエンドポイントを起動する

ft serveでサービングプロセスを起動し、OpenAI互換またはAnthropic互換のクライアントをポート1919に接続します。エージェントワークフローでは、ft launch claudeを使って、対応するコーディングクライアントをローカルエンドポイントに接続できます。

互換性に関する警告

公開されているベンチマーク値を、すべてのNVIDIAカードで保証される結果として扱わないでください。ドライバーのバージョン、量子化形式、ホストRAM、PCIeトポロジー、熱制限によって、性能は大きく変化する可能性があります。

MoEページングとキャッシュの仕組み

中心となる課題は、大規模モデルを保存することだけではありません。適切なエキスパートを、適切なタイミングで、適切な実行場所へ移動することも重要です。トークンごとにルーティングが変わるため、従来の静的な配置は非効率になる場合があります。あるリクエストではほとんど使われなかったエキスパートが、次のデコードステップでは重要になることもあります。

FreeTokenは、関連する3つの仕組みによってこの問題に対処します。

1つ目は、帯域幅適応型実行です。PCIe経由で処理すべき量と、CPU上に残すべき量を推定します。システムはホストメモリ帯域幅とPCIe帯域幅をプロファイルし、その結果を使ってキャッシュミスを分割します。これは、固定的な「GPU優先」または「CPUフォールバック」ルールよりも柔軟です。

2つ目は、セマンティック対応キャッシュです。エージェントワークロードにとって意味のあるコンテキスト境界を使用します。チェックポイントは、思考ブロック、ツール呼び出し、ツール出力に合わせて設定できます。エージェントが会話の末尾を編集した場合、ランタイムは以前の処理をすべて繰り返すのではなく、変更された末尾部分だけをプリフィルすればよい場合があります。

3つ目は、柔軟なメモリ管理です。VRAM予算を変更したうえで、安全なスケジューラーポイントにおいてGPUエキスパートキャッシュを再構築できます。完全なエンジン再起動やGPU全体のウォームアップを必要とせず、エキスパートを最終的なホストレイアウトへ読み込めます。

仕組み動作原理主な利点
帯域幅適応型実行キャッシュミスをPCIe転送とCPU計算に分割する実際のマシンプロファイルを活用する
セマンティック対応キャッシュエージェント境界に反復状態のチェックポイントを配置するプリフィルの繰り返しを削減する
グローバルLRUエキスパートキャッシュMoEの各層にまたがってキャッシュ判断を共有する変化するルーター需要を追跡する
柔軟なメモリ管理新しいVRAM予算に基づいてGPUキャッシュを再構築するエンジンを再起動せずに適応できる
直接ホスト読み込みエキスパートを最終的なホストレイアウトへ直接読み込む不要な再配置を避ける

同じキャッシュ容量で比較した場合、引用された評価では、グローバルLRU戦略によるQwen3.6プールのデコード時エキスパート読み込みミス率は16%でした。これに対し、KTransformersは41%、llama.cppは62%でした。これらの数値は特定のテスト環境におけるものですが、エージェント型デコードでグローバルなルーティング認識が重要である理由を示しています。

最適化のポイント

最も大きな改善は、ルーティング、メモリ配置、帯域幅測定を連携させることで得られます。VRAMを増やすだけでは、MoEサービングにおけるすべてのボトルネックを解決できません。

性能ベンチマークとモデル適合性

報告された結果から、FreeTokenはオフラインのバッチ処理だけでなく、インタラクティブなローカル推論を目的としていることが分かります。RTX 5090では、ランタイムはBF16のQwen3.6-35B-A3Bで毎秒77~83トークン、MXFP4のDeepSeek-V4-Flashで毎秒22~25トークンを持続的に処理しました。

8GBのRTX 4060ノートPCでは、NVFP4ビルドにより35Bモデルを毎秒39.3トークンで提供しました。RTX PRO 6000では、約400億のアクティブパラメーターを持つGLM-5.2が毎秒14.9トークンに達し、引用されたテストにおけるllama.cppの毎秒7.3トークンを上回りました。

ハードウェアモデルまたはビルド報告スループットコンテキスト
RTX 5090Qwen3.6-35B-A3B、BF1677–83 tok/s持続的デコード
RTX 5090DeepSeek-V4-Flash、MXFP422–25 tok/s持続的デコード
RTX 4060、8GB35Bモデル、NVFP439.3 tok/sノートPC GPUでの結果
RTX PRO 6000GLM-5.2、アクティブ約40B14.9 tok/sllama.cppの7.3 tok/sとの比較
RTX 5090エージェント型ワークロードシングルターンデコードの12%以内報告された3つのワークロード

同じ評価では、テストマトリクス全体における最悪時の初回トークン生成時間は44秒未満でした。一部のケースでは、ベースラインエンジンのテール値がより高く、llama.cppは232秒、Ollamaは179秒、KTransformersは946秒に達しました。エージェントクライアントでは、起動の遅延が長いとタイムアウトにつながる可能性があるため、これらは有用な比較材料です。ただし、普遍的なベンチマークとして解釈すべきではありません。

最適:プライベートエージェント

  • ローカルコーディングアシスタント
  • 機密性の高いプロジェクトコンテキスト
  • 低レイテンシーのインタラクティブセッション
  • OpenAI互換クライアントのサポート

高い適合性:大規模MoEモデル

  • ローカルVRAMを超えるモデル
  • 動的なエキスパートルーティング
  • 十分なホストメモリ容量
  • GPUキャッシュのチューニングが必要

注意して使用:本番規模

  • 限られたワークステーションハードウェア
  • 多数の同時リクエスト
  • 厳格なレイテンシーのサービスレベル目標
  • データセンターの代替を期待する用途
ベンチマークの前提

FreeTokenは、ワークステーションでフロンティア規模のモデルをより利用しやすくします。しかし、同時実行数、モデルの読み込み時間、メモリ負荷、ハードウェア互換性が、実際のデプロイ上限を決定します。

デプロイチェックリストとトラブルシューティング

信頼性の高いFreeTokenのデプロイは、推測ではなく測定から始まります。マシンのプロファイルを確認し、互換性のあるモデル形式を選択してから、完全なエージェントスタックを接続する前に短いリクエストをテストしてください。

エンドポイントを準備完了と判断する前に、次のチェックリストを使用してください。

デプロイ準備状況:

  • NVIDIA GPUとR580以降のドライバーを確認する
  • CUDA 13と選択したNVFP4またはMXFP4ビルドを確認する
  • ft bench bwでPCIeとホストメモリの帯域幅を測定する
  • ローカルAPIエンドポイント用にポート1919を確保する
  • エージェントツールを有効にする前に短い補完をテストする
症状考えられる原因推奨される対処
インストールに失敗するドライバー、CUDA、またはアクセラレーターの不一致サポートされているビルドと環境を再確認する
デコード速度が低いホスト帯域幅が弱い、またはPCIeリンクの性能が低い帯域幅プロファイリングを実行し、トポロジーを確認する
エキスパートミスが頻発するキャッシュ予算が小さすぎる、またはルーティングが急激に変化する可能な範囲で利用可能なキャッシュを増やす
プリフィルレイテンシーが高いコンテキストが大きい、またはエキスパートトラフィックが広範囲セマンティックチェックポイントと短いテストプロンプトを使用する
エージェントがタイムアウトする初回トークンまでのテールレイテンシーが高すぎるワークロードを減らし、別のモデル形式を試すか、リモートランタイムを使用する

コーディングアシスタントでは、まず控えめなコンテキストと1回のツール呼び出しから始めてください。初回トークンのレイテンシー、デコード速度、ホストメモリ使用量、GPU使用率を観察します。GPUがアイドル状態である一方、CPUとメモリバスが飽和している場合、問題はモデル計算能力の不足ではなく、転送帯域幅またはホスト実行帯域幅にある可能性があります。

FreeTokenは、ドキュメントに記載された起動ワークフローを通じて、Claude Code、Codex、OpenCode、OpenClawにも接続できます。特にエンドポイントがローカルマシンの外部からアクセス可能な場合は、ツールを有効にする際の権限を最小限に保ってください。

セキュリティに関する注意

API互換のローカルエンドポイントであっても、サービス境界として扱う必要があります。ネットワークへの公開を制限し、エージェントの権限を確認し、ポート1919を信頼できないパブリックインターフェースに公開しないでください。

FreeToken 753bモデル FAQ

以下の回答では、2026年にローカルで753Bクラスのモデルを提供することを検討する開発者にとって、特に重要な実用上のポイントをまとめています。

Q: FreeToken自体が753Bモデルなのですか?

いいえ。FreeTokenはサービングエンジンです。753Bという表現はGLM-5.2を指しており、ワークステーションでの評価では、FreeTokenは約40Bのアクティブパラメーターでこのモデルを提供できると報告されています。

Q: FreeTokenは一般向けGPU 1枚で実行できますか?

引用された結果には、8GBのRTX 4060で35Bモデルを実行した例と、ワークステーションハードウェアでより大規模なモデルを実行した例が含まれています。1台のワークステーションGPU上でのGLM-5.2はRTX PRO 6000で報告されているため、ハードウェア容量とモデル形式は依然として重要です。

Q: CLIに必要なオペレーティングシステムとドライバーは何ですか?

ドキュメントに記載されたCLIの対象環境は、NVIDIA GPU、R580以降のドライバー、CUDA 13を備えたLinux x86-64です。WindowsとLinux向けのワンクリックデスクトップアプリも説明されています。

Q: なぜFreeTokenにはこれほど多くのホストメモリが必要なのですか?

MoEのスパース性はアクティブな計算量を削減しますが、非アクティブなエキスパートをモデルプールから取り除くわけではありません。これらのエキスパートはホストメモリに保持され、ルーティングで必要になったときに取得されます。

技術的な背景について詳しく知りたい場合は、MarkTechPostが公開したFreeToken 753B GLM-5.2分析記事を参照してください。この記事では、サービングアーキテクチャ、報告されたベンチマーク、インストールの詳細、デプロイ上の制限について解説しています。

最終的な推奨事項

プライバシー、ローカルでの制御、ワークステーションでの推論を重視する場合は、FreeTokenを使用してください。まず帯域幅をプロファイルし、正しい量子化ビルドを選択してから、ワークロードを拡大する前にエージェントのレイテンシーを検証しましょう。