lycoris-lora

library3.4.0pypypiunverified

LyCORIS is a PyTorch library implementing advanced LoRA variants (LoRA, LoHa, LoKr, (IA)^3, Diag-OFT, BOFT) for parameter-efficient fine-tuning, particularly for Stable Diffusion. Current version 3.4.0, requires Python >=3.10. Active development with monthly releases.

ai-ml

pip install lycoris-lora

github ↗package ↗

INSTALL

IMPORT

SIG · LYCORIS-LORA

lycoris-lora

ai-mlpythonv3.4.0

Install

65.7s avg

Import

—

Disk

4787MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.4.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 75.2s

py 3.11

✕ build_error

✓ 67.4s

py 3.12

✕ build_error

✓ 63.2s

py 3.13

✕ build_error

✓ 56.8s

py 3.9

✕ build_error

✕ timeout

4787MB installed

● package 4787MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

LycorisNetwork

✓ from lycoris import LycorisNetwork

✗ from lycoris.network import LycorisNetwork

In v3, LycorisNetwork is exposed at top-level. The old submodule path is deprecated.

create_lycoris_from_weights

✓ from lycoris.utils import create_lycoris_from_weights

✗ from lycoris import create_lycoris_from_weights

Utility functions moved to lycoris.utils in v3.

Create a basic LyCORIS network with LoRA algorithm.

import torch from lycoris import LycorisNetwork, create_lycoris model = LycorisNetwork( in_features=768, out_features=768, rank=4, algo='lora' # 'lora', 'loha', 'lokr', 'ia3', 'diyag-oft', 'boft' ) lycoris = create_lycoris(model, multiplier=1.0) print('LyCORIS module created successfully.')

Debug

Known issues

breakingIn v3.0.0, the import paths changed. `from lycoris.network import LycorisNetwork` is deprecated; use `from lycoris import LycorisNetwork`.

fix

Update imports to top-level `lycoris` module.

affects: >=3.0.0

breakingThe `LycorisNetwork` API changed: `create_lycoris` replaced the old `LycorisNetwork.apply_to` method.

fix

Use `create_lycoris(model, ...)` instead of `model.apply_to(...)`.

affects: >=3.0.0

gotchaLyCORIS modules are not serializable by default. Use `lycoris.save_weights()` and `lycoris.load_weights()` for checkpointing.

fix

Always use provided save/load methods, not torch.save on the network directly.

affects: all

deprecatedThe 'lora' algorithm is considered stable but 'lokr' may be deprecated in future releases.

fix

Prefer 'loha' or 'boft' for new projects.

affects: >=3.4.0

Upgrade

Version history

3.4.0latest on PyPI · released Nov 12, 2025

Audit

Dependencies

torchrequiredCore tensor computation and autograd.

diffusersoptionalIntegration for Stable Diffusion model loading and inference.

Agent activity

11 hits · last 30 days

node

Resources

githubhttps://github.com/KohakuBlueleaf/LyCORIS ↗

packagehttps://pypi.org/project/lycoris-lora/ ↗