ComfyUI LoRA Manager

Revolutionize your workflow with the ultimate LoRA companion for ComfyUI!

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:

🌐 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.

Get Extension from Chrome Web Store

📦 Install Firefox Extension (reviewed and verified by Mozilla)

📚 Learn More: Complete Tutorial

---

🤝 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 (1037)

Click to view all awesome supporters

2018cfh, Charles Blakemore, Rob Williams, megakirbs, Brennok, Takkan, Arlecchino Shion, stone9k, Mozzel, Gingko Biloba, Skalabananen, Polymorphic Indeterminate, Liam MacDougal, Marc Whiffen, Insomnia Art Designs, jeaness, Rosenthal, Francisco Tatis, Tobi_Swagg, Andrew Wilson, Greybush, Ricky Carter, VantAI, FreelancerZ, Kiba, Birdy, onesecondinosaur, Reno Lam, Sterilized, BadassArabianMofo, sig, Christian Byrne, DM, Sen314, Estragon, J\B/ 8r0wns0n, Snaggwort, ClockDaemon, Omnidex, Tyler Trebuchon, Release Cabrakan, SG, carozzz, James Dooley, zenbound, Buzzard, jmack, Adam Shaw, RedrockVP, James Todd, Fyf, レプサイ, Timmy, Lisster, Michael Wong, Illrigger, whudunit, Tom Corrigan, JackieWang, fnkylove, Yushio, Vik71it, Echo, Lilleman, Robert Stacey, PM, JORGE+LUIZ+HUSSNI+MESSIAS, jean jahren, quarz, Pascal Dahle, Greg, LarsesFPC, Aleksander Wujczyk, AM Kuro, JSST, lmsupporter, wfpearl, Baekdoosixt, Jonathan Ross, KD, Jack B Nimble, Nolife_M, Melville Parrish, daniel dove, Lustre, JW Sin, Alex, bh, Marlon Daniels, Starkselle, Aaron Bleuer, LacesOut!, greebles, Wicked Choices by ASLPro3D, JongWon Han, Jacob Hoehler, FinalyFree, Weasyl, Johnny, Cory Paza, Tak, Gonzalo Andre Allendes Lopez, Big Red, Luc Job, Philip Hempel, corde, Bishoujoker, aai, Briton Heilbrun, wildnut, MiraiKuriyamaSy, ViperC, $MetaSamsara, Sangheili460, MagnaInsomnia, Akira HentAI, Karl P., otaku fra, andrew.tappan, N/A, The Spawn, graysock, Greenmoustache, fancypants, W+K+White, Joboshy, JaxMax, Dan, Jwk0205, Bro Xie, batblue, carey6409, Olive, 太郎 ゲーム, Mark Corneglio, Some Guy Named Barry, AELOX, Dankin-Pics, Nicfit23, wamekukyouzin, drum matthieu, DogmaR34, Matt Wenzel, Frank Nitty, Lex Song, Christopher Michel, Serge Bekenkamp, AIJimmy, Antonio Pontes, kushiroK9, Dustin Chen, dan, Todd Keck, Mouthlessman, Edgar Tejeda, Weird_With_A_Beard, wackop, Phil, Pozadine1, Qarob, AIGooner, Luc, ProtonPrince, DiffDuck, elu3199, Hasturkun, Jon Sandman, Ubivis, CloudValley, thesoftwaredruid, wundershark, Carl G., mr_dinosaur, linnfrey, Jackthemind, griffin+dahlberg, John+Edwards, Dsperado, Digital, Agatha Chris Q, Josef Lanzl, seed123_AIart, Error_Rule34_Not_found, Roslynd, SarcasticHashtag, Geolog, Neco28, M Postkasse, David Ortega, Cristian Vazquez, The Magic Noob, DougPeterson, LeoZero, Jeff, Bruce, Kevin John Duck, Kevin Christopher, Blackfish95, Tori, dd, Paul Kroll, Ran C, itismyelement, Bas Imagineer, Dušan Ryban, John Statham, Adam Taylor, Metryman55, AlexDuKaNa, decoy, Tyrswood, Ray Wing, Ranzitho, Gus, MJG, ae, Tr4shP4nda, Gamalonia, capn, Mirko Katzula, dan, Piccio08, kumakichi, cppbel, Moon Knight, Kland, Hailshem, yukina, Brian M, New folder (1), sanborondon, jcay015, Erik Lopez, Mateo Curić, jinxedx, m, Pierce McBride, Mikko Hemilä, runte3221, Jamie Ogletree, dl0901dm, a _, James Coleman, Martial, Emil Andersson, Chad Idk, Fraser Cross, Sam, sjon kreutz, Ace Ventura, zounic, Naomi Hale Danchi, epicgamer0020690, Joshua Porrata, keemun, SuBu, RedPIXel, Wind, Nexus, Ramneek“Guy”Ashok, squid_actually, Nat_20, Edward Weeks, kyoumei, RadStorm04, JohnDoe42054, BillyHill, emyth, KitKatM, gzmzmvp, D, truethug, ElitaSSJ4, Matt+J, Andrew, Robert Wegemund, Littlehuggy, Gregory Kozhemiak, Brian Buie, Thought2Form, Sadlip, Eric Whitney, Joey Callahan, Ivan Tadic, Eris3D, Resist's Creations - Spicy Edition 🔥, Mike Simone, Wolffen, Morgandel, Theerat Jiramate, Jacob McDaniel, X, SloanSteddyAI, Temikus, Artokun, nwalker94, Michael Taylor, Derek Baker, Ouro Boros, Atilla Berke Pekduyar, Decx , Joseph, ken, Crocket, MudkipMedkitz, deanbrian, Alex Wortman, Cody, emadsultan, InformedViewz, Bubbafett, leaf, Skyfire83, Adam Rinehart, Pitpe11, TheD1rtyD03, moonpetal, g9p0o, TheHolySheep, Monte Won, SpringBootisTrash, carsten, ikok, Wolfe7D1, Aberr, elleshar666, aezin, RAIDiation, ACTUALLY_the_Real_Willem_Dafoe, Kauffy, Gooohokrbe, John J Linehan, OldBones, Elliot E, Zach Gonser, Nick Kage, Vane Holzer, psytrax, Cyrus Fett, hexxish, Michael Anthony Scott, notedfakes, NICHOLAS BAXLEY, Michael Scott, Ed Wang, Rops Alot, Wes Sims, Donor4115, Penfore, Gordon Cole, Jimmy Borup, Filippo Ferrari, ResidentDeviant, Solixer, AbstractAss, David LaVallee, socrasteeze, Ginnie, Pkrsky, nanana, J, Alan+Cano, FeralOpticsAI, Pavlaki, Doug+Rintoul, Noor, Yorunai, quantenmecha, Jason+Nash, DarkRoast, letzte, Sora+Yori, Duk3+Rand0m, Nathen+Choi, T, David Schenck, takyamtom, Михал Михалыч, Matt, FloPro4Sho, Frogmilk, SPJ, Bryan Rutkowski, Steven Owens, Xenon Xue, Edward Ten Eyck, Saya, jinksta187, Xeeosat, Manu Thetug, Lyavph, yuxz69, 四糸凜音, esthe, FrxzenSnxw, Nick “Loadstone” D, dc7431, Inversity, chriphost, IamAyam, low9, Winged, YassineKhaled, Y, MatteKey, Flob, ShiroSenpai, Gumbyte, Tan+Huynh, Bob+Barker, Dark_Pest, Eldithor, Alex, Karru, ChaChanoKo, ghoulars, null, Beau, redcarrot, powerbot99, Fthehappy, Jeff+Kesemeyer, Nasty+Hobbit, Andrew Marshall, Kalli Core, Ronan Delevacq, Taylor Funk, Gerald Welly, りん あめ, Tee Gee, tarek helmi, Max Marklund, Dave Abraham, Joaquin Hierrezuelo, Jarrid Lee, Joshua Gray, Kor, John Rednoulf, Edward Kennedy, Boba Smith, lh qwe, Sauv, conner, TenaciousD, Dmitry Ryzhov, DarkSunset, Princess Bright Eyes, Pete Pain, RHopkirk, Tigon, Maxim, Douglas Gaspar, George, dw, Marcus thronico, WRL_SPR, momokai, 몽타주, kudari, Whitepinetrader, OrganicArtifact, Raku, CHKeeho80, SRCRCOSS, Akkas+Haque, AZ+Party+Oasis, Alex+Zaw, Kachac, Inkognito, Rune+Osnes, PoorStudent, Supporter, ExLightSaber, vinter, YaboiRay, Sildoren, Darv, Seon+Song, 2turbo, Dmitry+Viznesenskiy, tanjin90, sternenkrieger, Pascalou, lighthawke, Patrick+Bryan, Obsidian.Studios, Richard, Zomba Mann, Aquaneo, 奚明 刘, shira1011, Neko Desco, 준희 김, Ben D, G, Vinarus, Leslie Andrew Ridings, Tomohiro Baba, Locrospiel, Noora, StudOx Tech, Poophead27 Blyat, TheFusion, matt, somethingtosay8, 3zS4QNQ4, Terminuz, ivistorm, Matt M., Ivan Imes, Borte, Ted Cart, Sage Himeros, Steam Steam, CryptoTraderJK, Zeeble, Davaitamin, Jack Lawfield, Draconach, Nathan, Kalle Björk, tedcor, ItsGeneralButtNaked, Fotek Design, Nacho Ferrando, Dkom22, Marcos Tortosa Carmona, Nihongasuki, MadSpin, inbijiburu, 地獄の禄, starbugx, Janik, Vir, Otokomyouri+, d, Jasper, megameganck, thomasand01, Shiba+Sama, Gold_miner_ego, Celestial+Kitten, bakeliteboy, TequiTequi, Homero+Banda, Nick, Monix, Trolinka, PredragR, Clauzmak, Nerick, SundayRage, matter, Ko-fi+Supporter, Adam+Spreer, lrdchs2, blikkies, Tú Nguyễn Lý Hoàng, Wolf and Fox Legends, ゼクス、六, Draven T, marioandluigi, Elemnt, Josh Snyder, swra, JollRodrigo, Aquatic Coffee, Room Light, yves.poezevara, Patryk Serious, Joseph Hanson, Focuschannel, Snorklebort, J M, Anthony Faxlandez, Slacks, Glenn Hoetker, Khánh Đặng, Homero Banda, yyuvuvu, Nomki, Pat Hen, SkibidiRizzler, Never_M, Jordan Shaw, Rudeff VonRod, Distortik, JC, Prompt Pirate, uwutismxd, zenobeus, Mitchell Robson, ryoma, dg, Stryker, smart.edge5178, Menard, SomeDude, raf8osz, eddy, mackeman, sniff, AIBot, Darren+Brown, Nick, kluu324, echo, badnews, 21omen, NopeNahGoodTy, BG, plonk, Kotetsu, meatyalien, Tony+V, Anvil+Girl, draganjankovic1975dj528, kinz, YoruHime, Mark+Staaf, Anthony+Rizzo, Michael+Fürmann, Aether, JACKY, imer, Kevin+Isom, Mobius2020, boston666, cocona, Welkor, BakunyuuWaifu, Dustin Hendel, JBsuede, Liberation, Anagra Nouma, tafapayo, Shock Shockor, Bradley Turner, Goldwaters, Zude, uruksayshi, GJT, nk8, Kyler, CHEL_C, Nimhloth, Justin Blaylock, aRtFuL_DodGeR, Justin Defer, Tsani Prodanov, MR.Bear, V Bj, Rj Joplin, Myrthrac, Taylor Dominy, Steven, Michael Hicks, Billy Gladky, MadGod, Probis, GhostyGhost, Maxon - Plans, Karlanx, operationancut, deadwishd, Youguang, TheJohnes, Digitalzombie, andrewzpong, BossGame, lrdchs, Tree Tagger, AIVORY3D, Kevinj, POPPIN, Charles+Missildine, heycloudy, gdfgfdgfds, Benjamin+Doerr, D, asatetanges, YireKim, Daevalus, Milky+Mai, PP, tortor, belligerencebk, Peter, T, zipzorpp, Anton, actual, Neko1967, conkisdonkis, Lorabitch, IshouI;;, SAVEagleBasement, BillyBoy84, Buecyb99, dubious1one, Brandon Thomas, Civitaier, moranqianlong, Ninja Tom, beltaloth, Oliverfish, Manuel Reyes, Xae Phiel, FinoRulez, Smokey Jesus, ThreadingReality, Kyron Mahan, Mythspire, Caleb Larson, TBitz33, Anonym dkjglfleeoeldldldlkf, dsffsdfsdfsdfsdfsdf, Ezokewn, Kurt, SendingRavens, fal, Faith, BigBoss, Michael Docherty, Sunny, Paul Hartsuyker, Supporter, elitassj, Jacob Winter, Somebody, Andrew Wilkinson, David, floeki75pad, Evgeniya Smolentseva, Neutrem, OniNoKen, shinonomeiro, Snille, MaartenAlbers, khanh duy, xybrightsummer, jreedatchison, PhilW, Cruel, MRBlack, Kiyoe, humptynutz, michael.isaza, Kalnei, Scott, Muratoraccio, D, spooke, Norn, Xynnyx, Rowaeca, tenser, ellipsesmark, Dirk+Mueller, Dustyboyo, (ᵕ+˶•́﹏•̀˶+), Brian+Harvey, JstDrwIt, Sumoninja, FrostByte404, mcmalt, cesasol, Null, fdfac, 8/4, ivan.morgado.siles, SEI, 미킹+말, BlackVortex, Eita, Krash, thababydjac, miduzza, Somebody, てぃんてぃんひーろー, you+halo9, cloudghost, Yongkwan+Lee, lucites, nickname, eriick, Lev+Lanevskiy, Jacky+Ho, generic404, abattoirblues, zounik, 4IXplr0r3r, hayden, ahoystan, Mysil, Tim, edk, Super Sigma Reborne, Veloce, Maumau2100, Joey Leto, Even, Vincent, ja s, Doug Mason, シア アナスタ, scoreswazey, Daniel Bennett, Beuhwtf, Owen Gwosdz, Gentle Sartori, David Murcko, Jacid, Ben Brogger, Jack Dole, max blo, Bouya shaka, Knives909, Maso, sbone, nick Meadows, Cjarasa, Kevin Wallace, King_of_Styx, ChicRic, Bastard-Sama, mercur, inusanorthcape, Kane Sturzebecher, ChaosDMNS, Yavizu3d, Yves Poezevara, Teriak47, Just me, Raf Stahelin, Вячеслав Маринин, Cola Matthew, Ratatosk, Mehdi Sekkaï, chri20q5, 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, a0e, Kiera+Paul, Kranael, Camus_dreizehn, sharkie, Jemz, tony6501, jakub+just, jrjr, PineAmbassador, joleo, Ennio, NekoNX, BadGuyGregFlanders, Kallen, Zatara, LetitiaDominica, MicroPy, Somebody, jmartindale85, remmy, JayOh, TheKoalaWolf, jochst, Lazarus, Hope, km69, mmmrko, ms411, HamAi, issaqua, Somebody, Somebody, Lars+Christian+Nygård, Cryphius, Connor+Hall, Macho+Grump, Morcoddd, fazefour33, MrSEIGE88, yarsev, Somebody, 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, Clan Heavy, Deni, Nico, Maximilian Krischan, socialcat, proto merp, _ G3n, Donovan Jenkins, Hans Meier, jboul, Michael Eid, Bob barker, Lazumo, Michael Rivera, karim ben brik, Hunter13294, Michael Zhu, Nemisu, Seraphy, 雨の心 落, AllTimeNoobie, jumpd, John C, CrowsComb21, Rim, Joel Braby, yfx507, Jairus Knudsen, Xan Dionysus, Mario Cano, Nathan lee, DafmanD2, Middo, Gary Chaboya, forbiddenatelierofficial, Thomas Sankowski, wknight, Moneymaker412K, unkeiknown, Towelie, SSOPROX, Alex Ross, Jean-françois SEMA, Chris, Tomi Arola, Grayfal, Charles Gibson, Andrew Ly, Eric Ulbrich, SinfulRoleplay, jimyjomson, Gerowinger, JaeHyun Jang, Chase Kwon, Kevin Harding, Drew B, Bob Ling, Inyoshu, Bad B PMV, Chad Barnes, redlines3, Adam Gardner, Sean Pierson, James Ming, vanditking, kripitonga, Rizzi, nimin, OMAR LUCIANO, TN, chan, nickneeme, Somebody, Somebody, Somebody, 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
  • Automatic block remapping for legacy Anima LoRAs on Anima 2.9B / 3.8B (details)

• 🔄 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
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

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:

# wildcards/color.txt
red
blue
green

Use it as __color__.

# 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:

     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:

     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:

     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.

Other Model Folders (Optional)

Besides LoRAs, checkpoints, and embeddings, LoRA Manager can optionally manage other model types — VAE, upscale models, text encoders, CLIP vision, and ControlNet. This feature is opt-in: enable it from Settings → Library → Other Models Management, or by setting "enable_other_models": true in settings.json.

When running as a ComfyUI plugin, these folders are picked up automatically from your ComfyUI folder configuration (including extra_model_paths.yaml) — no extra setup needed.

In standalone mode, add the corresponding keys to folder_paths in your settings.json (only the ones you want to manage):

{
  "enable_other_models": true,
  "folder_paths": {
    "loras": ["C:/path/to/your/loras_folder"],
    "checkpoints": ["C:/path/to/your/checkpoints_folder"],
    "unet": ["C:/path/to/your/diffusion_models_folder"],
    "embeddings": ["C:/path/to/your/embeddings_folder"],
    "vae": ["C:/path/to/your/vae_folder"],
    "upscale_models": ["C:/path/to/your/upscale_models_folder"],
    "text_encoders": ["C:/path/to/your/text_encoders_folder"],
    "clip_vision": ["C:/path/to/your/clip_vision_folder"],
    "controlnet": ["C:/path/to/your/controlnet_folder"]
  }
}

Available folder keys: vae, upscale_models, text_encoders (legacy alias: clip), clip_vision, controlnet. To manage only some of these types, toggle them under Settings → Library, or set "enabled_other_sub_types" explicitly, e.g. "enabled_other_sub_types": ["vae", "upscaler", "text_encoder"] (the default; add "clip_vision" and/or "controlnet" to manage those too). Restart standalone mode after editing settings.json.

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:

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:

npm run test:coverage

---

Documentation

• metadata.json Schema Documentation — Complete reference for the .metadata.json sidecar file format, including all fields, types, and examples for LoRA, Checkpoint, and Embedding models.
• Anima LoRA Block Compatibility — How legacy 28-block Anima LoRAs are remapped for Anima 2.9B / 3.8B, and how to disable it.

---

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 - For the experimental Nunchaku Qwen-Image LoRA support
• ComfyUI-SaveImageWithMetaData - For the image metadata functionality
• rgthree-comfy - For the lora loader functionality

---

☕ Support

If you find this project helpful, consider supporting its development:

WeChat: Click to view QR code

💬 Community

Join our Discord community for support, discussions, and updates: Discord Server