(QUICK NOTE: CivitAI seems to have changed their API so that it will require an API key for all model downloads, please see API Key Page for instructions)
Note v2 has some changes regarding the cli args of the program. Please read the README below or run civitdl --help
for the new arguments!
- To see changes to v2, go to Changes in v2 section.
Uses CLI to batch download Stable Diffusion models, metadata (including description of model, author, base model, example prompts and etc.) and example images (default is 3) of checkpoints, loras, and TI models from civitai!
- README Page
- Alias Page
- API Key Page
- Civitconfig / Configuration Page
- Civitdl Page
- Civitmisc Page
- Sorter Page
- civitdl (civitai-batch-download)
- Python3.8 or above
requirements.txt
pip3 install civitdl
# pip install civitdl # if pip3 is not found
git clone https://github.com/OwenTruong/civitdl.git # Clone the project
cd civitdl # CD into project directory
pip3 install . # Use pip if pip3 is not found
Build from source 2 (if the instruction above fails with UNKNOWN package installed, else ignore this section)
# Make sure you are in project directory # use pip if pip3 is not found
python3 -m build
pip3 install -r ./requirements.txt
pip3 install --upgrade dist/*.whl
To get started quickly, copy the command below.
- See civitdl doc for more info.
civitdl 123456 ./models
- Replace
123456
with your model of choice (it can be a civitai.com url or model id). - Replace
./models
with the directory you wish to download the model to.
Example with url:
civitdl https://civitai.com/models/123456 ./models
- Configuring the program might make your life easier. You would be able to set default sorter, max images, and api key to use without running any of those options in the main program!
- You would also be able to add and delete sorters and aliases from the program.
- Check civitconfig doc.
- Run
civitconfig --help
to check what options are available!
- basic and tags sorter now downloads metadata and images to
/parent_dir/extra_data/
instead of to/parent_dir/
- Sorter is now more flexible/customizable (i.e. able to select individual paths model, metadata and images should go to)
- Added support for providing API Key to program to download restricted models.
- See api key doc
- Added multiple new options to the main program, civitdl.
- See civitdl doc
- Added configuration to set defaults for options, and to create alias + sorters.
- See civitconfig doc
- Concurrently download images.
- Isolates each image's prompt/metadata from the model's metadata.
- Able to retry download if model fails initially.
- Faster requests.
- Added features to skip model download if model already exists in path, or locally in cache.
If you encounter similar warning on Linux/Windows while building and installing manually:
WARNING: The script civitdl is installed in '/home/OwenTruong/.local/bin' which is not on PATH.
Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
For Linux, please concat the path to your PATH env, example:
echo 'PATH="$HOME/.local/bin:"$PATH' >> ~/.bashrc
source ~/.bashrc
For Windows, this may help: https://www.computerhope.com/issues/ch000549.htm
If you are building from source and the following packages are not available setuptools, wheel, build
, please install them with pip install setuptools wheel build
Thanks for the interest in the project!
Please create an issue if you encounter any problem, bugs or if you have a feature request.
To debug things, it is recommended to run with --verbose
option.
- Running in verbose allows users to print tracebacks and other messages useful for debugging.
- Example:
civitdl 123456 ./models --verbose
To work on an issue:
- Please create a fork.
- Then clone your fork locally.
- Then create a local branch that describes the issue.
- Once you have commited your changes, push the branch to your forked repository.
- Then open a pull request to this repository.
This project is licensed under the Apache License 2.0 - see the LICENSE.md file for details