- 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 | インストール前にアーキテクチャを確認する |
| GPU | NVIDIA GPU | ドライバーがカードを認識していることを確認する |
| ドライバー | R580以降 | nvidia-smiで確認する |
| CUDA | CUDA 13が対象 | ランタイムとアクセラレーターのビルドを一致させる |
| パッケージ | PyPIのfreetoken[accel] | 分離された環境内にインストールする |
| APIポート | ポート 1919 | ローカルサービング用にポートを確保する |
NVIDIA環境を確認する
GPUが認識されていること、ドライバーがR580以降の要件を満たしていること、CUDAスタックが使用するFreeTokenビルドと互換性があることを確認します。モデルを選択する前に、利用可能なVRAMとシステムRAMを記録してください。
アクセラレーション対応パッケージをインストールする
分離されたPython環境を作成し、使用するワークフローでサポートされているパッケージマネージャーを使ってfreetoken[accel]をインストールします。トラブルシューティングを簡単にするため、他の推論エンジンとは環境を分けてください。
システム帯域幅を測定する
ft bench bwを実行して、PCIe転送帯域幅とホストメモリ帯域幅の関係をプロファイルします。FreeTokenはこの測定結果を使って、キャッシュミスをGPUへの転送とCPU実行の間でどのように分担するかを決定します。
互換性のあるエンドポイントを起動する
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 5090 | Qwen3.6-35B-A3B、BF16 | 77–83 tok/s | 持続的デコード |
| RTX 5090 | DeepSeek-V4-Flash、MXFP4 | 22–25 tok/s | 持続的デコード |
| RTX 4060、8GB | 35Bモデル、NVFP4 | 39.3 tok/s | ノートPC GPUでの結果 |
| RTX PRO 6000 | GLM-5.2、アクティブ約40B | 14.9 tok/s | llama.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を使用してください。まず帯域幅をプロファイルし、正しい量子化ビルドを選択してから、ワークロードを拡大する前にエージェントのレイテンシーを検証しましょう。