Web UIまたはCLIから、一般向けGPUで画像・動画・音声の拡散モデルをファインチューニングできるオールインワンの学習ツールキット。
KohakuBlueleaf/LyCORIS
Stable Diffusionモデル向けに、LoRA、LoHa、LoKr、(IA)^3、DyLoRAなどのパラメータ効率の高いファインチューニング手法を実装するPythonライブラリ。
- スター
- 2,538
- フォーク
- 187
- 未解決の Issue
- 7
- 最終コミット
- 19 日前
これは何?
LyCORISは、Stable Diffusion向けの複数のパラメータ効率の高いファインチューニングアルゴリズムを実装したPythonライブラリです。LoRA(LoConを含む)に加え、LoHa、LoKr、(IA)^3、DyLoRA、ネイティブなファインチューニングにも対応しており、画像モデルをカスタマイズする際に、再現性、柔軟性、多様性、ファイルサイズのバランスを調整できます。
このパッケージは、kohya-ss sd-scriptsの学習パイプライン、Naifu-Diffusion経由、またはcreate_lycorisとLycorisNetwork APIを使って任意のPyTorchモジュールにアダプターを追加するスタンドアロンのラッパーとして利用できます。学習済みのLyCORISモデルは、AUTOMATIC1111のweb UI(1.5.0以降)、ComfyUI、InvokeAI、CivitAIで読み込めます。バージョン4.0.0では、バックエンドを自動選択し、必要に応じて標準のPyTorchにフォールバックする、実験的なfused TritonおよびTileLangカーネルが追加されました。
このプロジェクトはLoConから派生したもので、ICLR 2024の論文も公開されています。
主な機能
- 01LoRA/LoCon、LoHa、LoKr、(IA)^3、DyLoRA、ネイティブなファインチューニングを実装しています。
- 02kohya sd-scripts、Naifu-Diffusion、HCP-Diffusionによる学習に対応しています。
- 03任意のPyTorchモジュールで使えるスタンドアロンのラッパーAPIを提供します。
- 04モデル形式間の変換や、チェックポイントへの統合に使えるスクリプトを提供します。
- 05バックエンドを自動選択する実験的なfusedカーネルを搭載しています。
ユースケース
- Stable Diffusionモデル向けに、キャラクターやスタイルをカスタマイズするLoRA系アダプターを学習する。
- LoRA、LoHa、LoKrを比較し、画像モデルに使うファインチューニング手法を選ぶ。
- スタンドアロンのラッパーを使って、独自のPyTorchモデルにパラメータ効率の高いアダプターを追加する。
- HCP-Diffusionの出力を変換し、AUTOMATIC1111のweb UIで使えるようにする。
クイックスタート
- 1
PyPIからパッケージをインストールする
pip install lycoris-lora - 2
融合カーネルを使う場合は、任意でTritonをインストールする(実験的)
pip install triton
使う前に知っておきたいこと
- 融合カーネルはまだ初期段階の実験的機能で、誤った結果を生成する場合があります。フォールバックとしてtorchバックエンドを固定できます。
- ドキュメントやトレーニングのワークフローはkohya sd-scriptsなどの外部ツールに依存するため、セットアップには複数のコンポーネントが必要です。
収録されている特集
トピック
よくある質問
- LyCORIS とは?
- Stable Diffusionモデル向けに、LoRA、LoHa、LoKr、(IA)^3、DyLoRAなどのパラメータ効率の高いファインチューニング手法を実装するPythonライブラリ。 LyCORISは、Stable Diffusion向けの複数のパラメータ効率の高いファインチューニングアルゴリズムを実装したPythonライブラリです。LoRA(LoConを含む)に加え、LoHa、LoKr、(IA)^3、DyLoRA、ネイティブなファインチューニングにも対応しており、画像モデルをカスタマイズする際に、再現性、柔軟性、多様性、ファイルサイズのバランスを調整できます。
- LyCORIS は無料で使えますか?ライセンスは?
- LyCORIS は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- LyCORIS は今もメンテナンスされていますか?
- 活発にメンテナンス中。LyCORIS の最終コミットは 2026年10月19日 です。
- LyCORIS は何に使えますか?
- Stable Diffusionモデル向けに、キャラクターやスタイルをカスタマイズするLoRA系アダプターを学習する。 LoRA、LoHa、LoKrを比較し、画像モデルに使うファインチューニング手法を選ぶ。 スタンドアロンのラッパーを使って、独自のPyTorchモデルにパラメータ効率の高いアダプターを追加する。 HCP-Diffusionの出力を変換し、AUTOMATIC1111のweb UIで使えるようにする。
- LyCORIS のインストール方法は?
- PyPIからパッケージをインストールする: pip install lycoris-lora 融合カーネルを使う場合は、任意でTritonをインストールする(実験的): pip install triton
- LyCORIS はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/KohakuBlueleaf/LyCORIS
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Stable Diffusionなどの画像生成モデル向け学習・生成・ユーティリティスクリプト。LoRAやファインチューニングに対応。
Hugging FaceのParameter-Efficient Fine-Tuning(PEFT)ライブラリ。少数の追加パラメータだけを学習し、大規模な事前学習済みモデルを適応させます。
画像・動画・音声・3Dコンテンツをローカル生成するためのノードグラフGUI、API、バックエンド。
低VRAMでの推論・学習に対応した、画像・動画・音声生成向けのオープンソースDiffusionモデルエンジン。
テキストの正確な描画、JSONによるレイアウト制御、ファインチューニングに対応したオープンソースの5Bパラメータ画像生成モデル。