Repolode
tensorchord

tensorchord/envd

Python製のbuild.envdファイルから、AI/ML向けの再現可能なコンテナベースの開発環境を構築するCLIツール。

スター
2,242
フォーク
169
未解決の Issue
136
最終コミット
4 日前

これは何?

envdは、AIや機械学習向けのコンテナベースの開発環境を作成するコマンドラインツールです。必要なパッケージ、言語ランタイム、サービスをPythonで記述したbuild.envdファイルに宣言し、envd upを実行して環境を構築・起動します。CUDA関連ツール、Pythonパッケージ、Jupyter、シェルなどのセットアップ手順は、手書きのDockerfileやシェルスクリプトではなく、関数呼び出しで記述できます。

環境はBuildKitでビルドされ、OCI互換イメージとして生成されるため、Docker HubやHarborなどのレジストリにプッシュできます。envd contextを切り替えれば、同じビルドファイルをローカルマシンでもKubernetesクラスターでも実行できます。pipとaptのパッケージキャッシュはビルド間で再利用でき、リモートマシンでのビルドにも対応しています。

include関数でGitリポジトリをインポートすれば、再利用可能な関数を共有できます。これにより、TensorBoardの設定など、共通のセットアップ処理をチームで一元管理できます。

主な機能

  • 01Pythonのbuild.envdファイルで環境を定義し、envd upで実行する。
  • 02コンテナレジストリにプッシュできるOCI互換イメージを生成する。
  • 03同じ環境をローカルまたはKubernetesクラスターで実行する。
  • 04ビルド間でpipとaptのダウンロードをキャッシュし、リモートビルドにも対応する。
  • 05includeを使ってGitリポジトリから再利用可能な関数をインポートする。

ユースケース

  • モデルのトレーニングやファインチューニング向けに、再現可能なPython・CUDA環境を構築する。
  • 数行のビルド設定でJupyter環境を起動する。
  • コンテナレジストリを通じて、チーム共通の開発環境を共有する。
  • より高性能なリモートマシンにイメージのビルドを委ねる。

クイックスタート

  1. 1

    pipでenvdをインストールする

    pip install --upgrade envd
  2. 2

    envdを初期化する

    envd bootstrap
  3. 3

    クイックスタートリポジトリをクローンする

    git clone https://github.com/tensorchord/envd-quick-start.git
  4. 4

    環境をビルドして入る

    cd envd-quick-start && envd up

使う前に知っておきたいこと

  • 実行にはDocker 20.10.0以上が必要です。
  • v1.0以降、デフォルトのbuild.envd構文がv1に変更されたため、古いv0の例はアップグレードが必要な場合があります。

トピック

よくある質問

envd とは?
Python製のbuild.envdファイルから、AI/ML向けの再現可能なコンテナベースの開発環境を構築するCLIツール。 envdは、AIや機械学習向けのコンテナベースの開発環境を作成するコマンドラインツールです。必要なパッケージ、言語ランタイム、サービスをPythonで記述したbuild.envdファイルに宣言し、envd upを実行して環境を構築・起動します。CUDA関連ツール、Pythonパッケージ、Jupyter、シェルなどのセットアップ手順は、手書きのDockerfileやシェルスクリプトではなく、関数呼び出しで記述できます。
envd は無料で使えますか?ライセンスは?
envd は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
envd は今もメンテナンスされていますか?
活発にメンテナンス中。envd の最終コミットは 2026年11月2日 です。
envd は何に使えますか?
モデルのトレーニングやファインチューニング向けに、再現可能なPython・CUDA環境を構築する。 数行のビルド設定でJupyter環境を起動する。 コンテナレジストリを通じて、チーム共通の開発環境を共有する。 より高性能なリモートマシンにイメージのビルドを委ねる。
envd のインストール方法は?
pipでenvdをインストールする: pip install --upgrade envd envdを初期化する: envd bootstrap クイックスタートリポジトリをクローンする: git clone https://github.com/tensorchord/envd-quick-start.git 環境をビルドして入る: cd envd-quick-start && envd up
envd はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/tensorchord/envd

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト