# ComfyUI LoRA Manager
> **Revolutionize your workflow with the ultimate LoRA companion for ComfyUI!**
[](https://discord.gg/vcqNrWVFvM)
[](https://github.com/willmiao/ComfyUI-Lora-Manager/releases)
[](https://github.com/willmiao/ComfyUI-Lora-Manager/releases)
A comprehensive toolset that streamlines organizing, downloading, and applying LoRA models in ComfyUI. With powerful features like recipe management, checkpoint organization, and one-click workflow integration, working with models becomes faster, smoother, and significantly easier. Access the interface at: `http://localhost:8188/loras`
## 📺 Tutorial: One-Click LoRA Integration
Watch this quick tutorial to learn how to use the new one-click LoRA integration feature:
[](https://youtu.be/hvKw31YpE-U)
## 🌐 Browser Extension
Enhance your Civitai browsing experience with our companion browser extension! See which models you already have, download new ones with a single click, and manage your downloads efficiently.
📚 [Learn More: Complete Tutorial](https://github.com/willmiao/ComfyUI-Lora-Manager/wiki/LoRA-Manager-Civitai-Extension-(Chrome-Extension))
---
## 🤝 Supporter Recognition
I'm incredibly grateful to everyone who has supported the development of this project. Seeing so many people value my work is the best motivation I could ask for. Your trust and support have played a vital role in shaping this tool into what it is today, and I want to personally recognize those who have helped make it possible.
### 🌟 Special Thanks
**dispenser**, **EbonEagle**, **DanielMagPizza**, **Scott R**
### 💖 Supporters (890)
Click to view all awesome supporters
2018cfh, megakirbs, Brennok, Insomnia Art Designs, Charles Blakemore, Rob Williams, Arlecchino Shion, stone9k, $MetaSamsara, W+K+White, Rosenthal, Francisco Tatis, Andrew Wilson, Greybush, Ricky Carter, JongWon Han, VantAI, FreelancerZ, Edgar Tejeda, Polymorphic Indeterminate, Liam MacDougal, Skalabananen, Marc Whiffen, Mozzel, Gingko Biloba, Birdy, Kiba, Reno Lam, onesecondinosaur, sig, Christian Byrne, DM, Sen314, Estragon, J\B/ 8r0wns0n, Snaggwort, wackop, Phil, Carl G., Dsperado, ClockDaemon, KD, Omnidex, Tyler Trebuchon, Release Cabrakan, Tobi_Swagg, SG, carozzz, James Dooley, zenbound, Buzzard, jmack, Mark Corneglio, SarcasticHashtag, RedrockVP, James Todd, Steven Pfeiffer, レプサイ, Lisster, Michael Wong, Illrigger, Tom Corrigan, JackieWang, fnkylove, Yushio, Vik71it, Echo, Lilleman, Robert Stacey, PM, Todd Keck, Sterilized, BadassArabianMofo, Dogwalkerbr, itismyelement, quarz, Pascal Dahle, Greg, jean jahren, JSST, lmsupporter, wfpearl, MKULTRA, Baekdoosixt, Jonathan Ross, Jack B Nimble, Nolife_M, Melville Parrish, daniel dove, Lustre, JW Sin, Alex, bh, Marlon Daniels, Starkselle, Aaron Bleuer, LacesOut!, greebles, Adam Shaw, M Postkasse, Wicked Choices by ASLPro3D, Jacob Hoehler, FinalyFree, Weasyl, Timmy, Johnny, Cory Paza, Tak, Gonzalo Andre Allendes Lopez, runte3221, Big Red, whudunit, Luc Job, dl0901dm, Philip Hempel, corde, Bishoujoker, aai, Briton Heilbrun, wildnut, Aleksander Wujczyk, AM Kuro, Fraser Cross, ViperC, Sangheili460, MagnaInsomnia, Akira HentAI, Karl P., MiraiKuriyamaSy, otaku fra, andrew.tappan, Takkan, N/A, The Spawn, graysock, Greenmoustache, zounic, fancypants, ElitaSSJ4, Matt+J, Joboshy, Digital, JaxMax, Jwk0205, Bro Xie, batblue, carey6409, Olive, 太郎 ゲーム, Some Guy Named Barry, Resist's Creations - Spicy Edition 🔥, AELOX, Wolffen, Nicfit23, wamekukyouzin, drum matthieu, DogmaR34, Matt Wenzel, Lex Song, Christopher Michel, Serge Bekenkamp, Jimmy Ledbetter, LeoZero, Antonio Pontes, nwalker94, kushiroK9, Dustin Chen, dan, Tori, Mouthlessman, Ran C, Adam Taylor, Weird_With_A_Beard, Pozadine1, Qarob, AIGooner, Luc, ProtonPrince, DiffDuck, elu3199, Hasturkun, Jon Sandman, Ubivis, CloudValley, thesoftwaredruid, wundershark, linnfrey, griffin+dahlberg, jeaness, John+Edwards, Bohemian Corporal, contrite831, Dan, Josef Lanzl, yer fey, Error_Rule34_Not_found, Roslynd, Geolog, jinxedx, Neco28, David Ortega, Gooohokrbe, Dankin-Pics, Cristian Vazquez, OldBones, Frank Nitty, Magic Noob, Zach Gonser, DougPeterson, Jeff, Bruce, Kevin John Duck, Kevin Christopher, Blackfish95, dd, Paul Kroll, Penfore, Bas Imagineer, John Statham, Gordon Cole, sjon kreutz, AbstractAss, LarsesFPC, Dušan Ryban, AlexDuKaNa, decoy, mr_dinosaur, Tyrswood, Ray Wing, Ranzitho, Gus, MJG, David LaVallee, ae, Tr4shP4nda, Gamalonia, capn, Joseph, Mirko Katzula, dan, Piccio08, kumakichi, cppbel, Moon Knight, Jackthemind, takyamtom, Brian M, Nerezza, sanborondon, aezin, Thought2Form, jcay015, Kevin Picco, Erik Lopez, Mateo Curić, Eris3D, m, FloPro4Sho, Pierce McBride, Mikko Hemilä, Jamie Ogletree, a _, Steven Owens, James Coleman, Martial, Emil Andersson, Ouro Boros, Chad Idk, Yuji Kaneko, Rops Alot, Sam, Ace Ventura, yuxz69, Metryman55, esthe, 地獄の禄, Kland, Hailshem, Naomi Hale Danchi, ken, epicgamer0020690, Joshua Porrata, keemun, SuBu, RedPIXel, Wind, Nexus, Ramneek“Guy”Ashok, squid_actually, Nat_20, Edward Weeks, kyoumei, RadStorm04, JohnDoe42054, BillyHill, emyth, chriphost, KitKatM, socrasteeze, IamAyam, gzmzmvp, Andrew, Robert Wegemund, Littlehuggy, Andrew Marshall, Gregory Kozhemiak, Brian Buie, Taylor Funk, Gerald Welly, Sadlip, Tee Gee, tarek helmi, Eric Whitney, Joey Callahan, Ivan Tadic, Max Marklund, Mike Simone, Joshua Gray, Morgandel, Pronredn, Jacob McDaniel, X, Sloan Steddy, Temikus, Artokun, Michael Taylor, Derek Baker, lh qwe, conner, Michael Anthony Scott, Atilla Berke Pekduyar, Princess Bright Eyes, Decx _, 四糸凜音, Xeeosat, Douglas Gaspar, Saya, George, dw, FrxzenSnxw, WRL_SPR, momokai, 몽타주, kudari, Crocket, OrganicArtifact, ResidentDeviant, MudkipMedkitz, deanbrian, Alex Wortman, Cody, emadsultan, InformedViewz, CHKeeho80, Bubbafett, leaf, Skyfire83, Adam Rinehart, Pitpe11, TheD1rtyD03, moonpetal, g9p0o, Pkrsky, TheHolySheep, Monte Won, SpringBootisTrash, carsten, ikok, Richard, Wolfe7D1, 奚明 刘, Aberr, 준희 김, elleshar666, ACTUALLY_the_Real_Willem_Dafoe, Kauffy, Tomohiro Baba, Noora, John J Linehan, Elliot E, Theerat Jiramate, Nick Kage, Noah, Vane Holzer, psytrax, hexxish, notedfakes, Steam Steam, NICHOLAS BAXLEY, Michael Scott, CryptoTraderJK, Davaitamin, Nathan, Ed Wang, tedcor, Wes Sims, Fotek Design, Donor4115, Filippo Ferrari, Nihongasuki, MadSpin, inbijiburu, Nick “Loadstone” D, starbugx, dc7431, Ginnie, Raku, Vir, nanana, Alan+Cano, FeralOpticsAI, Pavlaki, Doug+Rintoul, Noor, Yorunai, quantenmecha, Jason+Nash, DarkRoast, Nasty+Hobbit, letzte, Sora+Yori, lrdchs2, Duk3+Rand0m, Nathen+Choi, T, David Schenck, Draven T, Time Valentine, Михал Михалыч, Matt, Aquatic Coffee, Frogmilk, ethanfel, SPJ, Bryan Rutkowski, Focuschannel, Edward Kennedy, Cyrus Fett, Anthony Faxlandez, battu, Xenon Xue, DarkSunset, Edward Ten Eyck, Pat Hen, Solixer, Jordan Shaw, jinksta187, g unit, Jimmy Borup, Manu Thetug, Lyavph, Distortik, JC, Prompt Pirate, uwutismxd, zenobeus, Inversity, ryoma, Whitepinetrader, Stryker, smart.edge5178, Menard, SomeDude, raf8osz, boston666, YassineKhaled, Y, MatteKey, gumbyte, Flob, ShiroSenpai, Inkognito, Tan+Huynh, Bob+Barker, D, Dark_Pest, Eldithor, Alex, Karru, ChaChanoKo, redcarrot, ghoulars, null, Beau, powerbot99, Fthehappy, Ko-fi+Supporter, J, cocona, blikkies, JBsuede, Tú Nguyễn Lý Hoàng, Kalli Core, Ronan Delevacq, Shock Shockor, りん あめ, Goldwaters, Zude, Dave Abraham, Joaquin Hierrezuelo, Sean voets, Jarrid Lee, Kyler, Kor, Joseph Hanson, John Rednoulf, Justin Blaylock, Boba Smith, aRtFuL_DodGeR, Sauv, Steven, TenaciousD, Dmitry Ryzhov, Billy Gladky, Probis, Pete Pain, ItsGeneralButtNaked, RHopkirk, Maxim, Karlanx, operationancut, Youguang, andrewzpong, BossGame, Marcus thronico, lrdchs, Tree Tagger, AIVORY3D, Kevinj, Mitchell Robson, POPPIN, SRCRCOSS, imer, Akkas+Haque, AZ+Party+Oasis, Kevin+Isom, Kachac, SAVEagleBasement, Adam+Spreer, Rune+Osnes, PoorStudent, Alex+Zaw, Supporter, ExLightSaber, Mobius2020, YaboiRay, Sildoren, Darv, Seon+Song, 2turbo, Dmitry+Viznesenskiy, tanjin90, sternenkrieger, Pascalou, Patrick+Bryan, lighthawke, low9, Winged, BillyBoy84, Buecyb99, Welkor, dubious1one, Obsidian.Studios, Zomba Mann, shira1011, moranqianlong, Neko Desco, Ben D, Ninja Tom, G, Vinarus, Christian Schäfer, Leslie Andrew Ridings, Locrospiel, Poophead27 Blyat, Kyron Mahan, Mythspire, TBitz33, Anonym dkjglfleeoeldldldlkf, TheFusion, MR.Bear, matt, somethingtosay8, 3zS4QNQ4, Ezokewn, Terminuz, ivistorm, SendingRavens, Ivan Imes, JackJohnnyJim, Jack Lawfield, Khánh Đặng, Borte, Michael Docherty, Ted Cart, Sage Himeros, Zeeble, Paul Hartsuyker, elitassj, Tigon, SkibidiRizzler, Tania Nayelli Fernandez, Draconach, Jacob Winter, Ryan Presley Ng, Kalle Björk, Andrew Wilkinson, David, Meilo, Nacho Ferrando, Marcos Tortosa Carmona, Dkom22, shinonomeiro, Snille, MaartenAlbers, khanh duy, xybrightsummer, jreedatchison, PhilW, Janik, Cruel, MRBlack, Kiyoe, humptynutz, michael.isaza, Kalnei, dg, Scott, Muratoraccio, D, YoruHime, Jasper, megameganck, thomasand01, Shiba+Sama, Somebody, Celestial+Kitten, TequiTequi, Homero+Banda, bakeliteboy, Nick, てぃんてぃんひーろー, Gold_miner_ego, IshouI;_;, Monix, Trolinka, PredragR, Clauzmak, Nerick, SundayRage, matter, you+halo9, cloudghost, Yongkwan+Lee, lucites, nickname, eriick, Lev+Lanevskiy, Jacky+Ho, generic404, abattoirblues, zounik, 4IXplr0r3r, hayden, ahoystan, Aquaneo, Brandon Thomas, edk, Wolf and Fox Legends, Elemnt, Josh Snyder, ja s, Doug Mason, swra, JollRodrigo, scoreswazey, Oliverfish, Owen Gwosdz, Room Light, Patryk Serious, Nimhloth, Gentle Sartori, Snorklebort, David Murcko, legostudio, Jack Dole, max blo, Matt M., J M, Slacks, Glenn Hoetker, Bouya shaka, Maso, Homero Banda, yyuvuvu, Nomki, Kevin Wallace, ChicRic, BastardSama, mercur, Never_M, Yavizu3d, Rudeff VonRod, Yves Poezevara, Teriak47, Just me, Raf Stahelin, Вячеслав Маринин, Cola Matthew, deadwishd, OniNoKen, Iain Wisely, Zertens, NOHOW, Apo, nekotxt, choowkee, Clusters, ibrahim, Highlandrise, philcoraz, mztn, ImagineerNL, MrAcrtosSursus, al300680, pixl, Robin, chahknoir, nd, keno94d, James Melzer, Bartleby, Renvertere, Rahuy, Hermann003, D, Foolish, RevyHiep, Captain_Swag, obkircher, gwyar, ResidentDeviant, D, edgecase, Neoxena, mrmhalo, Maarten Harms, Israel, SelfishMedic, adderleighn, EnragedAntelope, Darren+Brown, Nick, kluu324, copycatmay, MackeMan, conkisdonkis, badnews, Lorabitch, 21omen, NopeNahGoodTy, Brandon+G, fazefour33, plonk, Kotetsu, o, Tony+V, Anvil+G, draganjankovic1975dj528, MrSEIGE88, yarsev, M+Alsulaiti, Mark+Staaf, Michael+Fürmann, Aether, GhostyGhost, JACKY, Jesse, daga, Somebody, miduzza, KB, shw, Jim, JoL, Srdb, jcx29, Drizzly, Nebuleux, Join+Chun, GDS+DEV, 4rt+r3d, Somebody, Somebody, Crescent~San, AiGirlTS, datasl4ve, Somebody, koopa990, The+Forgetful+Dev, Mateusz+Kosela, Bula, KUJYAKU, Coeur+de+cochon, han b, Nico, Maximilian Krischan, socialcat, proto merp, _ G3n, Donovan Jenkins, Hans Meier, BakunyuuWaifu, Dustin Hendel, jboul, Michael Eid, Liberation, Bob barker, karim ben brik, tafapayo, Bradley Turner, Michael Zhu, Nemisu, Seraphy, 雨の心 落, AllTimeNoobie, jumpd, John C, Rim, Beuhwtf, yfx507, uruksayshi, Jairus Knudsen, Xan Dionysus, Manuel Reyes, Nathan lee, nk8, lylepaul, Middo, Gary Chaboya, forbiddenatelierofficial, CHEL_C, Thomas Sankowski, DrB, wknight, Moneymaker412K, Justin Defer, Tsani Prodanov, Towelie, V Bj, Jean-françois SEMA, Rj Joplin, Myrthrac, Taylor Dominy, Andrew Ly, Faith, john Greene, Faburizu, jimyjomson, JaeHyun Jang, Michael Hicks, Chase Kwon, Bob Ling, Inyoshu, Chad Barnes, MadGod, Adam Gardner, inusanorthcape, James Ming, vanditking, kripitonga, Rizzi, nimin, OMAR LUCIANO, Somebody, CoffeeMage, Ken+Suzuki, hannibal, Jo+Example, BrentBertram, eumelzocker, dxjaymz, L C, Dude, Somebody, CK
## **⚠ Important Note**: To use the CivitAI download feature, you'll need to:
1. Get your CivitAI API key from your profile settings
2. Add it to the LoRA Manager settings page
3. Save the settings
---
## Key Features
- 🚀 **High Performance**
- Fast model loading and browsing
- Smooth scrolling through large collections
- 🌐 **Rich Model Integration**
- Direct download from CivitAI
- Preview images and videos
- Model descriptions and version selection
- Trigger words at a glance
- One-click workflow integration with preset values
- 🔄 **Checkpoint Management**
- Scan and organize checkpoint models
- Filter and search your collection
- View and edit metadata
- Clean up and manage disk space
- 🧩 **LoRA Recipes**
- Save and share favorite LoRA combinations
- Preserve generation parameters for future reference
- Quick application to workflows
- Import/export functionality for community sharing
- 💻 **User Friendly**
- One-click access from ComfyUI menu
- Context menu for quick actions
- Custom notes and usage tips
- Multi-folder support
- Configurable mature blur threshold (`PG13` / `R` / `X` / `XXX`, default `R+`)
- Example: setting threshold to `PG13` blurs `PG13`, `R`, `X`, and `XXX` previews when blur is enabled
- Visual progress indicators during initialization
---
## Installation
### Option 1: **ComfyUI Manager** (Recommended for ComfyUI users)
1. Open **ComfyUI**.
2. Go to **Manager > Custom Node Manager**.
3. Search for `lora-manager`.
4. Click **Install**.
### Option 2: **Portable Standalone Edition** (No ComfyUI required)
1. Download the [Portable Package](https://github.com/willmiao/ComfyUI-Lora-Manager/releases/download/v1.0.10/lora_manager_portable.7z)
2. Copy the provided `settings.json.example` file to create a new file named `settings.json` in `comfyui-lora-manager` folder.
3. Edit the new `settings.json` to include your correct model folder paths and CivitAI API key
- Set `"use_portable_settings": true` if you want the configuration to remain inside the repository folder instead of your user settings directory.
4. Run run.bat
- To change the startup port, edit `run.bat` and modify the parameter (e.g. `--port 9001`)
### Option 3: **Manual Installation**
```bash
git clone https://github.com/willmiao/ComfyUI-Lora-Manager.git
cd ComfyUI-Lora-Manager
pip install -r requirements.txt
```
## Usage
1. There are two ways to access the LoRA manager:
- Click the "Launch LoRA Manager" button in the ComfyUI menu
- Visit http://localhost:8188/loras directly
2. From the interface, you can:
- Browse and organize your LoRA models
- Download models directly from CivitAI
- Automatically fetch or manually set preview images
- View and copy trigger words associated with each LoRA
- Add personal notes and usage tips
3. To use LoRAs in your workflow:
- Add the "Lora Loader (LoraManager)" node to your workflow
- Select a LoRA in the manager interface
- Click copy button or use right-click menu "Copy LoRA syntax"
- Paste into the Lora Loader node's text input
- The node will automatically apply preset strength and trigger words
### Wildcards for TextLM / PromptLM
`Text (LoraManager)` and `Prompt (LoraManager)` support `/wildcard` autocomplete plus runtime wildcard expansion.
- Wildcard files live in `{settings folder}/wildcards/`
- When you type `/wildcard` and no wildcard files exist yet, the autocomplete dropdown shows the exact folder path and lets you open it
- Supported formats: `.txt`, `.yaml`, `.yml`, `.json`
Format rules:
- `wildcards/animals/cat.txt` becomes `__animals/cat__`
- `.txt` files use one option per line
- YAML / JSON files use nested keys that end in string arrays
Examples:
```txt
# wildcards/color.txt
red
blue
green
```
Use it as `__color__`.
```yaml
# wildcards/colors.yaml
palette:
warm:
- red
- orange
```
Use it as `__palette/warm__`.
### Filename Format Patterns for Save Image Node
The Save Image Node supports dynamic filename generation using pattern codes. You can customize how your images are named using the following format patterns:
#### Available Pattern Codes
##### Cross-Node Placeholders (ComfyUI Standard)
- `%NodeTitle.WidgetName%` - Reference any widget value from any node in your workflow, for example:
- `%KSampler.seed%` - The seed from a KSampler node
- `%Empty Latent Image.width%` - The width from an Empty Latent Image node
- `%KSampler.steps%` - The steps value from a KSampler node
- Nodes are matched by their "Node name for S&R" property, then by their title
##### Generation Metadata Placeholders (LoRA Manager)
- `%seed%` - Inserts the generation seed number
- `%width%` - Inserts the image width
- `%height%` - Inserts the image height
- `%pprompt:N%` - Inserts the positive prompt (limited to N characters)
- `%nprompt:N%` - Inserts the negative prompt (limited to N characters)
- `%model:N%` - Inserts the model/checkpoint name (limited to N characters)
##### Date/Time Placeholders
- `%date%` - Inserts current date/time as "yyyyMMddhhmmss"
- `%date:FORMAT%` - Inserts date using custom format with:
- `yyyy` - 4-digit year
- `yy` - 2-digit year
- `MM` - 2-digit month
- `dd` - 2-digit day
- `hh` - 2-digit hour
- `mm` - 2-digit minute
- `ss` - 2-digit second
#### Examples
- `image_%seed%` → `image_1234567890`
- `gen_%width%x%height%` → `gen_512x768`
- `%model:10%_%seed%` → `dreamshape_1234567890`
- `%date:yyyy-MM-dd%` → `2025-04-28`
- `%pprompt:20%_%seed%` → `beautiful landscape_1234567890`
- `%model%_%date:yyMMdd%_%seed%` → `dreamshaper_v8_250428_1234567890`
- `%KSampler.seed%` → `1234567890` (resolved from the KSampler node's widget)
- `%Empty Latent Image.width%x%Empty Latent Image.height%` → `512x768`
- `%KSampler.seed%_%KSampler.steps%` → `1234567890_25`
You can combine multiple patterns to create detailed, organized filenames for your generated images. Cross-node and metadata placeholders can be mixed freely — for example: `%KSampler.seed%_%model%_%date:yyyyMMdd%`.
##### Organizing Images into Subdirectories
Including a path separator (`/` on all platforms) in the filename prefix creates subdirectories automatically, which is especially powerful when combined with placeholders:
| Pattern | Result |
|---|---|
| `%date:yyyy-MM-dd%/%seed%` | Saves to `2025-04-28/1234567890.png` |
| `%model%/%date:yyMMdd%_%seed%` | Saves to `dreamshaper_v8/250428_1234567890.png` |
| `%KSampler.seed%/%model%` | Saves to `1234567890/dreamshaper_v8.png` |
| `%date:yyyy/MM/dd%/%seed%` | Saves to `2025/04/28/1234567890.png` (nested year/month/day) |
| `%model%/training/%seed%` | Saves to `dreamshaper_v8/training/1234567890.png` |
> **Note**: The subdirectory is created relative to your ComfyUI output directory (configurable via `--output-directory`). Characters invalid for folder names are automatically replaced with underscores.
### Standalone Mode
You can now run LoRA Manager independently from ComfyUI:
1. **For ComfyUI users**:
- Launch ComfyUI with LoRA Manager at least once to initialize the necessary path information in the `settings.json` file located in your user settings folder (see paths above).
- Make sure dependencies are installed: `pip install -r requirements.txt`
- From your ComfyUI root directory, run:
```bash
python custom_nodes\comfyui-lora-manager\standalone.py
```
- Access the interface at: `http://localhost:8188/loras`
- You can specify a different host or port with arguments:
```bash
python custom_nodes\comfyui-lora-manager\standalone.py --host 127.0.0.1 --port 9000
```
2. **For non-ComfyUI users**:
- Copy the provided `settings.json.example` file to create a new file named `settings.json`. Update the API key, optional language, and folder paths only—the library registry is created automatically when LoRA Manager starts.
- Edit `settings.json` to include your correct model folder paths and CivitAI API key (you can leave the defaults until ready to configure them)
- Enable portable mode by setting `"use_portable_settings": true` if you prefer LoRA Manager to read and write the `settings.json` located in the project directory.
- Install required dependencies: `pip install -r requirements.txt`
- Run standalone mode:
```bash
python standalone.py
```
- Access the interface through your browser at: `http://localhost:8188/loras`
> **Note:** Existing installations automatically migrate the legacy `settings.json` from the plugin folder to the user settings directory the first time you launch this version.
This standalone mode provides a lightweight option for managing your model and recipe collection without needing to run the full ComfyUI environment, making it useful even for users who primarily use other stable diffusion interfaces.
## Testing & Coverage
### Backend
Install the development dependencies and run pytest with coverage reports:
```bash
pip install -r requirements-dev.txt
COVERAGE_FILE=coverage/backend/.coverage pytest \
--cov=py \
--cov=standalone \
--cov-report=term-missing \
--cov-report=html:coverage/backend/html \
--cov-report=xml:coverage/backend/coverage.xml \
--cov-report=json:coverage/backend/coverage.json
```
HTML, XML, and JSON artifacts are stored under `coverage/backend/` so you can inspect hot spots locally or from CI artifacts.
### Frontend
Run the Vitest coverage suite to analyze widget hot spots:
```bash
npm run test:coverage
```
---
## Documentation
- **[metadata.json Schema Documentation](docs/metadata-json-schema.md)** — Complete reference for the `.metadata.json` sidecar file format, including all fields, types, and examples for LoRA, Checkpoint, and Embedding models.
---
## Contributing
Thank you for your interest in contributing to ComfyUI LoRA Manager! As this project is currently in its early stages and undergoing rapid development and refactoring, we are temporarily not accepting pull requests.
However, your feedback and ideas are extremely valuable to us:
- Please feel free to open issues for any bugs you encounter
- Submit feature requests through GitHub issues
- Share your suggestions for improvements
We appreciate your understanding and look forward to potentially accepting code contributions once the project architecture stabilizes.
---
## Credits
This project has been inspired by and benefited from other excellent ComfyUI extensions:
- [ComfyUI-QwenImageLoraLoader](https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader) - For the experimental Nunchaku Qwen-Image LoRA support
- [ComfyUI-SaveImageWithMetaData](https://github.com/nkchocoai/ComfyUI-SaveImageWithMetaData) - For the image metadata functionality
- [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) - For the lora loader functionality
---
## ☕ Support
If you find this project helpful, consider supporting its development:
[](https://ko-fi.com/pixelpawsai)
[](https://patreon.com/PixelPawsAI)
WeChat: [Click to view QR code](https://raw.githubusercontent.com/willmiao/ComfyUI-Lora-Manager/main/static/images/wechat-qr.webp)
## 💬 Community
Join our Discord community for support, discussions, and updates:
[Discord Server](https://discord.gg/vcqNrWVFvM)
---
## Star History
[](https://star-history.com/#willmiao/ComfyUI-Lora-Manager&Date)
Get Extension from Chrome Web Store