{"id":13579430,"url":"https://github.com/ashleykleynhans/supir-docker","last_synced_at":"2025-12-24T10:35:42.645Z","repository":{"id":224700589,"uuid":"763982714","full_name":"ashleykleynhans/supir-docker","owner":"ashleykleynhans","description":"Docker image for SUPIR (Scaling Up to Excellence: Practicing Model Scaling for Photo-Realistic Image Restoration In the Wild)","archived":false,"fork":false,"pushed_at":"2024-04-17T14:38:36.000Z","size":63,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-02T01:50:00.827Z","etag":null,"topics":["deep-learning","diffusion-models","docker","docker-image","llava","pytorch","pytorch-lightning","restoration","runpod","sdxl","stable-diffusion","super-resolution","upscaling"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashleykleynhans.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"ashleykleynhans","buy_me_a_coffee":"ashleyk"}},"created_at":"2024-02-27T09:13:29.000Z","updated_at":"2024-05-07T13:26:38.461Z","dependencies_parsed_at":"2024-02-27T10:57:49.698Z","dependency_job_id":"8a892108-c264-48fa-87a6-5b1291cd59a4","html_url":"https://github.com/ashleykleynhans/supir-docker","commit_stats":null,"previous_names":["ashleykleynhans/supir-docker"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashleykleynhans%2Fsupir-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashleykleynhans%2Fsupir-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashleykleynhans%2Fsupir-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashleykleynhans%2Fsupir-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashleykleynhans","download_url":"https://codeload.github.com/ashleykleynhans/supir-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399888,"owners_count":20932876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deep-learning","diffusion-models","docker","docker-image","llava","pytorch","pytorch-lightning","restoration","runpod","sdxl","stable-diffusion","super-resolution","upscaling"],"created_at":"2024-08-01T15:01:39.323Z","updated_at":"2025-12-24T10:35:42.584Z","avatar_url":"https://github.com/ashleykleynhans.png","language":"Shell","funding_links":["https://github.com/sponsors/ashleykleynhans","https://buymeacoffee.com/ashleyk","https://www.buymeacoffee.com/ashleyk"],"categories":["Shell"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Docker image for SUPIR (Scaling Up to Excellence: Practicing Model Scaling for Photo-Realistic Image Restoration In the Wild)\n\n![Docker Pulls](https://img.shields.io/docker/pulls/ashleykza/supir?style=for-the-badge\u0026logo=docker\u0026label=Docker%20Pulls\u0026link=https%3A%2F%2Fhub.docker.com%2Frepository%2Fdocker%2Fashleykza%2Fsupir%2Fgeneral)\n![Template Version](https://img.shields.io/github/v/tag/ashleykleynhans/supir-docker?style=for-the-badge\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDI2LjUuMywgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCAyMDAwIDIwMDAiIHN0eWxlPSJlbmFibGUtYmFja2dyb3VuZDpuZXcgMCAwIDIwMDAgMjAwMDsiIHhtbDpzcGFjZT0icHJlc2VydmUiPgo8c3R5bGUgdHlwZT0idGV4dC9jc3MiPgoJLnN0MHtmaWxsOiM2NzNBQjc7fQo8L3N0eWxlPgo8Zz4KCTxnPgoJCTxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik0xMDE3Ljk1LDcxMS4wNGMtNC4yMiwyLjM2LTkuMTgsMy4wMS0xMy44NiwxLjgyTDM4Ni4xNyw1NTUuM2MtNDEuNzItMTAuNzYtODYuMDItMC42My0xMTYuNiwyOS43MwoJCQlsLTEuNCwxLjM5Yy0zNS45MiwzNS42NS0yNy41NSw5NS44LDE2Ljc0LDEyMC4zbDU4NC4zMiwzMjQuMjNjMzEuMzYsMTcuNCw1MC44Miw1MC40NSw1MC44Miw4Ni4zMnY4MDYuNzYKCQkJYzAsMzUuNDktMzguNDEsNTcuNjctNjkuMTUsMzkuOTRsLTcwMy4xNS00MDUuNjRjLTIzLjYtMTMuNjEtMzguMTMtMzguNzgtMzguMTMtNjYuMDJWNjY2LjYzYzAtODcuMjQsNDYuNDUtMTY3Ljg5LDEyMS45Mi0yMTEuNjYKCQkJTDkzMy44NSw0Mi4xNWMyMy40OC0xMy44LDUxLjQ3LTE3LjcsNzcuODMtMTAuODRsNzQ1LjcxLDE5NC4xYzMxLjUzLDguMjEsMzYuOTksNTAuNjUsOC41Niw2Ni41N0wxMDE3Ljk1LDcxMS4wNHoiLz4KCQk8cGF0aCBjbGFzcz0ic3QwIiBkPSJNMTUyNy43NSw1MzYuMzhsMTI4Ljg5LTc5LjYzbDE4OS45MiwxMDkuMTdjMjcuMjQsMTUuNjYsNDMuOTcsNDQuNzMsNDMuODIsNzYuMTVsLTQsODU3LjYKCQkJYy0wLjExLDI0LjM5LTEzLjE1LDQ2Ljg5LTM0LjI1LDU5LjExbC03MDEuNzUsNDA2LjYxYy0zMi4zLDE4LjcxLTcyLjc0LTQuNTktNzIuNzQtNDEuOTJ2LTc5Ny40MwoJCQljMC0zOC45OCwyMS4wNi03NC45MSw1NS4wNy05My45Nmw1OTAuMTctMzMwLjUzYzE4LjIzLTEwLjIxLDE4LjY1LTM2LjMsMC43NS00Ny4wOUwxNTI3Ljc1LDUzNi4zOHoiLz4KCQk8cGF0aCBjbGFzcz0ic3QwIiBkPSJNMTUyNC4wMSw2NjUuOTEiLz4KCTwvZz4KPC9nPgo8L3N2Zz4K\u0026logoColor=%23ffffff\u0026label=Template%20Version\u0026color=%23673ab7)\n\n\u003c/div\u003e\n\n\u003e [!IMPORTANT]\n\u003e This needs at least 24GB VRAM for 1x upscale. If you want to upscale more than 1x,\n\u003e you will need more than 24GB of VRAM.  48GB VRAM is recommended.\n\n\u003e [!NOTE]\n\u003e Loading of models on start takes a few minutes, so you can view the log\n\u003e to watch the progress. You will be able to access the port when you see \n\u003e `Running on local URL:  http://0.0.0.0:3001` in the log.\n\n## Installs\n\n* Ubuntu 22.04 LTS\n* CUDA 12.1\n* Python 3.10.12\n* [SUPIR](\n  https://github.com/ashleykleynhans/SUPIR)\n* Torch 2.3.1\n* xformers 0.0.27\n* [Jupyter Lab](https://github.com/jupyterlab/jupyterlab)\n* [code-server](https://github.com/coder/code-server)\n* [runpodctl](https://github.com/runpod/runpodctl)\n* [OhMyRunPod](https://github.com/kodxana/OhMyRunPod)\n* [RunPod File Uploader](https://github.com/kodxana/RunPod-FilleUploader)\n* [croc](https://github.com/schollz/croc)\n* [rclone](https://rclone.org/)\n\n## Available on RunPod\n\nThis image is designed to work on [RunPod](https://runpod.io?ref=2xxro4sy).\nYou can use my custom [RunPod template](\nhttps://runpod.io/console/gpu-cloud?template=aa31uo64wv\u0026ref=2xxro4sy)\nto launch it on RunPod.\n\n## Building the Docker image\n\n\u003e [!NOTE]\n\u003e You will need to edit the `docker-bake.hcl` file and update `USERNAME`,\n\u003e and `RELEASE`.  You can obviously edit the other values too, but these\n\u003e are the most important ones.\n\n```bash\n# Clone the repo\ngit clone https://github.com/ashleykleynhans/supir-docker.git\n\n# Log in to Docker Hub\ndocker login\n\n# Build the image, tag the image, and push the image to Docker Hub\ncd supir-docker\ndocker buildx bake -f docker-bake.hcl --push\n```\n\n## Running Locally\n\n### Install Nvidia CUDA Driver\n\n- [Linux](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html)\n- [Windows](https://docs.nvidia.com/cuda/cuda-installation-guide-microsoft-windows/index.html)\n\n### Start the Docker container\n\n```bash\ndocker run -d \\\n  --gpus all \\\n  -v /workspace \\\n  -p 3000:3001 \\\n  -p 7777:7777 \\\n  -p 8888:8888 \\\n  -p 2999:2999 \\\n  ashleykza/supir:latest\n```\n\n## Models\n\n| Model                             | Description |\n|-----------------------------------|-------------|\n| SUPIR-v0F.ckpt                    | SUPIR F     |\n| SUPIR-v0Q.ckpt                    | SUPIR Q     |\n| liuhaotian/llava-v1.5-7b          | LLaVA       |\n| sd_xl_base_1.0_0.9vae.safetensors | SDXL        |\n| openai/clip-vit-large-patch14-336 | LLaVA CLIP  |\n| openai/clip-vit-large-patch14     | SDXL CLIP1  |\n| open_clip_pytorch_model.bin       | SDXL CLIP2  |\n\nYou can obviously substitute the image name and tag with your own.\n\n## Ports\n\n| Connect Port | Internal Port | Description          |\n|--------------|---------------|----------------------|\n| 3000         | 3001          | SUPIR                |\n| 7777         | 7777          | Code Server          |\n| 8888         | 8888          | Jupyter Lab          |\n| 2999         | 2999          | RunPod File Uploader |\n\n## Environment Variables\n\n| Variable             | Description                                      | Default                |\n|----------------------|--------------------------------------------------|------------------------|\n| JUPYTER_LAB_PASSWORD | Set a password for Jupyter lab                   | not set - no password  |\n| DISABLE_AUTOLAUNCH   | Disable SUPIR from launching automatically       | (not set)              |\n| DISABLE_SYNC         | Disable syncing if using a RunPod network volume | (not set)              |\n| NO_GPU_OPTIMIZATION  | Disable GPU optimization for A100/H100           | (not set)              |\n\n## Logs\n\nSUPIR creates a log file, and you can tail the log instead of\nkilling the service to view the logs.\n\n| Application | Log file                  |\n|-------------|---------------------------|\n| SUPIR       | /workspace/logs/supir.log |\n\nFor example:\n\n```bash\ntail -f /workspace/logs/supir.log\n```\n\n## Community and Contributing\n\nPull requests and issues on [GitHub](https://github.com/ashleykleynhans/supir-docker)\nare welcome. Bug fixes and new features are encouraged.\n\n## Appreciate my work?\n\n\u003ca href=\"https://www.buymeacoffee.com/ashleyk\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashleykleynhans%2Fsupir-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashleykleynhans%2Fsupir-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashleykleynhans%2Fsupir-docker/lists"}