モデルコードの完全な制御を保ちながら、学習ループやマルチGPU対応、定型的なエンジニアリング作業を自動化するPyTorchベースの深層学習フレームワーク。
basetenlabs/truss
MLモデルを本番用モデルサーバーとしてBasetenまたは独自インフラにパッケージ化・デプロイするためのCLIとPythonツールキット。
- スター
- 1,229
- フォーク
- 142
- 未解決の Issue
- 90
- 最終コミット
- 昨日
これは何?
Trussはモデルのサービングロジック、重み、依存関係をコンテナ対応のモデルサーバーにまとめ、Basetenまたは独自インフラにデプロイします。カスタムコード用のPythonモデルクラスと、GPUの種類などのハードウェアやビルドオプションを指定するconfig.yamlを使って操作します。ライブリロード開発モードで反復作業を進められ、DockerやKubernetesの設定も自動で処理されます。
vLLM、SGLang、TensorRT-LLM、transformers、diffusers、PyTorch、TensorFlowなど、一般的なオープンソースフレームワークのモデルに対応しています。LLMでは、FP8量子化や最大シーケンス長などのオプションを指定してconfigからTensorRT-LLMエンジンをビルドでき、デプロイするとOpenAI互換APIが公開されます。本番運用向けの機能として、Baseten上でのGPU設定、シークレット、キャッシュ、自動スケーリングを備えています。
サービング基盤を自前で構築せずに、Hugging FaceのモデルやカスタムPyTorchモデルをホスト型エンドポイントとして公開したいチームに適しています。また、エディターの自動補完を可能にするconfig.yaml用のJSONスキーマもリポジトリに含まれています。
主な機能
- 01モデルコード、重み、依存関係をモデルサーバーにパッケージ化
- 02反復作業を高速化するライブリロード開発モード
- 03YAML設定からFP8量子化対応のTensorRT-LLMエンジンをビルド
- 04LLMのデプロイでOpenAI互換エンドポイントを提供
- 05vLLM、SGLang、transformers、diffusers、PyTorch、TensorFlowのモデルに対応
- 06Baseten上でGPU設定、シークレット、キャッシュ、自動スケーリングを提供
ユースケース
- Dockerfileを書かずにHugging FaceのLLMをホスト型APIエンドポイントとしてデプロイ
- GPUアクセラレーションを活用し、カスタムPyTorchモデルやdiffusionモデルを本番環境でサービング
- 手作業で構築したモデルサービングスタックを、設定駆動のワークフローに置き換える
クイックスタート
- 1
pipでTrussをインストールする
pip install --upgrade truss - 2
Basetenにログインする
uvx truss login - 3
新しいプロジェクトをスキャフォールドする
uvx truss init qwen-2.5-3b && cd qwen-2.5-3b - 4
モデルをBasetenにデプロイする
uvx truss push
使う前に知っておきたいこと
- クイックスタートのデプロイには、BasetenアカウントとAPIキーが必要です。
- クイックスタートのTRT-LLMデプロイには、Baseten上のL4 GPUが必要です。また、TRT-LLMでは--watchモードはサポートされていません。
収録されている特集
トピック
よくある質問
- truss とは?
- MLモデルを本番用モデルサーバーとしてBasetenまたは独自インフラにパッケージ化・デプロイするためのCLIとPythonツールキット。 Trussはモデルのサービングロジック、重み、依存関係をコンテナ対応のモデルサーバーにまとめ、Basetenまたは独自インフラにデプロイします。カスタムコード用のPythonモデルクラスと、GPUの種類などのハードウェアやビルドオプションを指定するconfig.yamlを使って操作します。ライブリロード開発モードで反復作業を進められ、DockerやKubernetesの設定も自動で処理されます。
- truss は無料で使えますか?ライセンスは?
- truss は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- truss は今もメンテナンスされていますか?
- 活発にメンテナンス中。truss の最終コミットは 2026年11月5日 です。
- truss は何に使えますか?
- Dockerfileを書かずにHugging FaceのLLMをホスト型APIエンドポイントとしてデプロイ GPUアクセラレーションを活用し、カスタムPyTorchモデルやdiffusionモデルを本番環境でサービング 手作業で構築したモデルサービングスタックを、設定駆動のワークフローに置き換える
- truss のインストール方法は?
- pipでTrussをインストールする: pip install --upgrade truss Basetenにログインする: uvx truss login 新しいプロジェクトをスキャフォールドする: uvx truss init qwen-2.5-3b && cd qwen-2.5-3b モデルをBasetenにデプロイする: uvx truss push
- truss はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/basetenlabs/truss
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
REST API経由で画像、テキスト、表形式データ、時系列データのモデルを学習・実行できる、ディープラーニングサーバー、Python wheel、CLI。
Modular Platformは、AIモデルの開発とデプロイに向けた、MAX AI frameworkとMojo programming languageのオープンソース基盤です。
YAML設定からLLM、マルチモーダルモデル、表形式データモデルを学習・ファインチューニング・デプロイできる宣言型深層学習フレームワーク。
PyTorch、TensorFlow、ONNXなどの深層学習モデルをHTTPエンドポイント経由で提供する、Javaベースのスタンドアロンモデルサービングソリューション。
OpenVINOで最適化した生成AIモデルや従来型のディープラーニングモデルを、OpenAI互換APIとKServe APIで提供するC++推論サーバーです。