{"id":50568210,"url":"https://github.com/spacecodee/comfyui-docker-compose","last_synced_at":"2026-06-04T16:30:54.256Z","repository":{"id":349616188,"uuid":"1203062904","full_name":"spacecodee/comfyui-docker-compose","owner":"spacecodee","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-06T18:52:15.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T20:29:19.748Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spacecodee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-06T17:24:53.000Z","updated_at":"2026-04-06T18:52:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/spacecodee/comfyui-docker-compose","commit_stats":null,"previous_names":["spacecodee/comfyui-docker-compose"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/spacecodee/comfyui-docker-compose","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacecodee%2Fcomfyui-docker-compose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacecodee%2Fcomfyui-docker-compose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacecodee%2Fcomfyui-docker-compose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacecodee%2Fcomfyui-docker-compose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spacecodee","download_url":"https://codeload.github.com/spacecodee/comfyui-docker-compose/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacecodee%2Fcomfyui-docker-compose/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33914543,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2026-06-04T16:30:52.857Z","updated_at":"2026-06-04T16:30:54.244Z","avatar_url":"https://github.com/spacecodee.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# comfyui-local-workspace\n\nThis repository has been simplified to run ComfyUI locally.\nIt no longer uses Docker or Docker Compose.\n\nThe dedicated synced directories are:\n\n- data/workflows\n- data/input\n- data/output\n\nThis keeps your workflows and I/O inside your project folder.\nEverything else (models, custom nodes, etc.) lives directly in ./comfyui.\n\n## What is included now\n\n- scripts/setup-local.sh: clones/updates ComfyUI into ./comfyui, prepares Python dependencies (venv or existing env), and links workflows/input/output.\n- scripts/run-comfyui.sh: commands for setup, local start, custom node deps, preview setup, and model downloads.\n- scripts/install-custom-node-deps.sh: installs custom node dependencies from requirements*.txt or pyproject.toml.\n- scripts/prepare-data-dirs.sh: ensures data/workflows, data/workflows/editing, data/input, and data/output.\n- scripts/setup-preview-method.sh: downloads TAESD decoders for --preview-method (automatic or manual).\n- scripts/model-download.sh: downloads models from Hugging Face or CivitAI into ComfyUI model folders.\n- scripts/downloads/download-z-image-turbo.sh: downloads required models for Z-Image-Turbo.\n- scripts/downloads/download-z-image-base.sh: downloads required models for Z-Image-Base.\n- scripts/downloads/download-ltx-2.3.sh: downloads required models for LTX-2.3.\n- scripts/downloads/download-wan-2.2.sh: downloads required models for WAN 2.2 (i2v, t2v, or all).\n- scripts/download-z-image-turbo.sh and scripts/download-z-image-base.sh remain as compatibility wrappers.\n- scripts/workflow-save.sh: copies workflows into the versioned directory.\n- scripts/workflow-move-to-edit.sh: moves workflows into editing (git-ignored).\n- .env.example: minimal local-mode configuration.\n\n## Structure\n\n```text\n.\n├── data/\n│   ├── input/\n│   │   └── .gitkeep\n│   ├── output/\n│   │   └── .gitkeep\n│   └── workflows/\n│       ├── .gitkeep\n│       └── editing/\n│           └── .gitkeep\n└── scripts/\n```\n\n## Requirements\n\n- Git\n- Python 3.13 recommended\n- python3-venv installed\n\nOn Ubuntu/Debian:\n\n```bash\nsudo apt update\nsudo apt install -y git python3 python3-venv\n```\n\n## Python and PyTorch Version Guidance\n\nPython:\n\n- Python 3.14 works, but some custom nodes may have issues.\n- Free-threaded Python works, but some dependencies re-enable the GIL, so it is not fully supported.\n- Python 3.13 is very well supported (recommended default).\n- If you hit custom node dependency problems on 3.13, try Python 3.12.\n- In managed environments that block virtualenv creation (for example some Studio/conda setups), set COMFY_USE_VENV=false.\n\nPyTorch:\n\n- Torch 2.4+ is supported.\n- Some features and optimizations may work better only on newer versions.\n- Recommended: latest major PyTorch version with the latest CUDA version, unless that release is less than two weeks old.\n\nTip: set COMFY_PYTHON_BIN in .env (for example python3.13) to control which Python version is used.\nTip: if you get \"Venv creation is not allowed\", set COMFY_USE_VENV=false.\n\n## Quick Start\n\n1. Create your local env file:\n\n```bash\ncp .env.example .env\n```\n\n2. Download/update ComfyUI and prepare the environment:\n\n```bash\n./scripts/run-comfyui.sh setup\n```\n\n3. Start ComfyUI:\n\n```bash\n./scripts/run-comfyui.sh start\n```\n\n4. Open in browser:\n\n```text\nhttp://127.0.0.1:8188\n```\n\nFor remote environments (Cloudspaces/Studio/Codespaces), use the forwarded/public URL for port 8188.\nIf you get HTTP 403, it is usually platform authorization/port-sharing policy, not a ComfyUI crash.\n\n## Workflows, Input, and Output Linking\n\nDuring setup and start, these links are created:\n\n```text\ncomfyui/user/default/workflows -\u003e data/workflows\ncomfyui/input -\u003e data/input\ncomfyui/output -\u003e data/output\n```\n\nThis means uploads in Input and generated files in Output remain in your project folder.\n\ndata/workflows/editing is kept for work-in-progress files and is ignored by git.\n\nBy default, data/input and data/output keep only .gitkeep in git, while runtime files are ignored.\n\n## Custom Nodes\n\nIn local mode, install custom nodes into:\n\n```text\ncomfyui/custom_nodes\n```\n\nDependencies can be installed with:\n\n```bash\n./scripts/run-comfyui.sh deps\n```\n\nAnd during start they are installed automatically if COMFY_AUTO_INSTALL_CUSTOM_NODE_DEPS=true.\n\n## Dependency Auto-Sync and Repair\n\nOn start, the runner can automatically:\n\n- sync ComfyUI core requirements when requirements.txt changes\n- install manager requirements when --enable-manager is active\n- install matrix-nio when --enable-manager is active (to avoid matrix sharing warning)\n- repair requests stack when RequestsDependencyWarning is detected\n- repair NumPy/SciPy ABI mismatches (for example NumPy 2.x with SciPy built for NumPy 1.x)\n- optionally upgrade torch/torchvision/torchaudio to cu130 wheels when torch cuda \u003c 13\n- repair torchaudio when it is incompatible with the installed torch build\n\nThis behavior is controlled by:\n\n- COMFY_AUTO_SYNC_REQUIREMENTS\n- COMFY_AUTO_INSTALL_MANAGER_REQUIREMENTS\n- COMFY_AUTO_INSTALL_MATRIX_NIO\n- COMFY_AUTO_FIX_REQUESTS_STACK\n- COMFY_AUTO_FIX_NUMPY_SCIPY_COMPAT\n- COMFY_AUTO_FIX_TORCH_CUDA130\n- COMFY_AUTO_FIX_TORCH_CUDA130_FORCE\n- COMFY_AUTO_FIX_TORCHAUDIO\n\nIf you still see this warning:\n\n- WARNING: You need pytorch with cu130 or higher to use optimized CUDA operations.\n\nCOMFY_AUTO_FIX_TORCH_CUDA130 is enabled by default. If needed, keep it true and run start once.\nSet it to false only if you explicitly want to skip torch/cu130 auto-upgrade.\n\n## Model Downloads (Hugging Face / CivitAI)\n\nYou can download models directly into ComfyUI model directories (checkpoints, loras, vae, etc.):\n\n```bash\n./scripts/model-download.sh --provider huggingface --model-dir checkpoints \\\n\t--repo Comfy-Org/stable-diffusion-v1-5-archive \\\n\t--file v1-5-pruned-emaonly-fp16.safetensors\n\n./scripts/model-download.sh --provider civitai --model-dir loras \\\n\t--model-id 12345 --output my_lora.safetensors\n```\n\nYou can also run it through the wrapper script:\n\n```bash\n./scripts/run-comfyui.sh model-download --provider civitai --model-dir checkpoints --model-id 12345\n```\n\nDestination root:\n\n- COMFY_MODELS_DIR if set\n- otherwise: \u003cCOMFYUI_DIR\u003e/models\n\nThe allowed model subdirectories are listed in scripts/comfy-model-dirs.txt.\n\n## Model Bundle Scripts\n\nPredefined bundle scripts are available in scripts/downloads:\n\n- Z-Image-Turbo: ./scripts/downloads/download-z-image-turbo.sh\n- Z-Image-Base: ./scripts/downloads/download-z-image-base.sh\n- LTX-2.3: ./scripts/downloads/download-ltx-2.3.sh\n- WAN 2.2: ./scripts/downloads/download-wan-2.2.sh --mode all\n\nWAN 2.2 modes:\n\n- --mode i2v: download only image-to-video files\n- --mode t2v: download only text-to-video files\n- --mode all: download both sets (default)\n\nAll bundle scripts:\n\n- use HF_TOKEN automatically when present (or --token override)\n- skip files that already exist unless --force is used\n- de-duplicate repeated file definitions in the same run\n\n## Environment Variables\n\nConfigure .env as needed:\n\n- COMFYUI_REPO_URL: ComfyUI repository URL (official repo by default).\n- COMFYUI_REF: branch/tag/commit to use.\n- COMFYUI_DIR: local ComfyUI directory (./comfyui).\n- COMFY_USE_VENV: true/false toggle for creating and using .venv.\n- COMFY_PYTHON_BIN: Python binary used by setup/start/deps (python3.13 recommended).\n- COMFY_VENV_DIR: local virtual environment directory (./.venv).\n- COMFY_WORKFLOWS_DIR: versioned workflows directory (./data/workflows).\n- COMFY_INPUT_DIR: synced input directory (./data/input).\n- COMFY_OUTPUT_DIR: synced output directory (./data/output).\n- COMFY_MODELS_DIR: optional models root override (defaults to \u003cCOMFYUI_DIR\u003e/models).\n- COMFYUI_HOST: web host binding.\n- COMFYUI_PORT: web port.\n- COMFY_AUTO_PUBLIC_BIND: auto-switch localhost host values to 0.0.0.0 in remote workspaces.\n- COMFY_AUTO_ENABLE_CORS_ON_REMOTE: auto-add --enable-cors-header in remote workspaces (or when binding to non-loopback hosts like 0.0.0.0).\n- COMFYUI_CORS_ORIGIN: origin value passed to --enable-cors-header (default *).\n- COMFY_AUTO_INIT_USERDATA_DEFAULTS: create frontend expected userdata defaults (subgraphs and comfy.templates.json).\n- COMFYUI_PREVIEW_METHOD: auto, taesd, latent2rgb, or none.\n- COMFYUI_EXTRA_ARGS: extra arguments passed to main.py.\n- COMFY_PREVIEW_AUTO_SETUP: download preview decoders during local setup.\n- COMFY_PREVIEW_MODELS_BASE_URL: download source for TAESD decoders.\n- COMFY_AUTO_INSTALL_CUSTOM_NODE_DEPS: install custom node dependencies on start.\n- COMFY_CUSTOM_NODE_DEPS_STRICT: fail if any dependency install fails.\n- COMFY_CUSTOM_NODE_DEPS_FORCE: reinstall dependencies even when unchanged.\n- COMFY_AUTO_SYNC_REQUIREMENTS: auto-install core requirements when requirements.txt changes.\n- COMFY_AUTO_INSTALL_MANAGER_REQUIREMENTS: auto-install manager requirements when --enable-manager is used.\n- COMFY_AUTO_INSTALL_MATRIX_NIO: install matrix-nio automatically for ComfyUI-Manager matrix sharing.\n- COMFY_AUTO_FIX_REQUESTS_STACK: repair requests/urllib3/chardet/charset-normalizer mismatch warning (caps urllib3 at \u003c=2.5.0 for lightning-sdk compatibility).\n- COMFY_AUTO_FIX_NUMPY_SCIPY_COMPAT: repair NumPy/SciPy incompatibility and pin NumPy to \u003c2 when needed.\n- COMFY_AUTO_FIX_TORCH_CUDA130: attempt torch/torchvision/torchaudio upgrade to cu130 when needed.\n- COMFY_AUTO_FIX_TORCH_CUDA130_FORCE: re-attempt cu130 upgrade even after a previous failed attempt.\n- COMFY_AUTO_FIX_TORCHAUDIO: attempt torchaudio repair when torch/torchaudio are mismatched.\n- HF_TOKEN: optional Hugging Face token used by model-download.sh.\n- CIVITAI_TOKEN: optional CivitAI token used by model-download.sh.\n\nDefault branch in this repo config is COMFYUI_REF=master.\n\n## Remote Access Notes (403 Forbidden)\n\nIf your browser shows HTTP 403 on a forwarded URL, check:\n\n- COMFYUI is listening on 0.0.0.0 (set COMFYUI_HOST=0.0.0.0).\n- CORS is enabled for remote proxies (set COMFY_AUTO_ENABLE_CORS_ON_REMOTE=true).\n- Port 8188 is shared/forwarded in your platform panel.\n- Your browser session is authorized for that workspace URL.\n\nThis repo sets COMFYUI_HOST=0.0.0.0, COMFY_AUTO_PUBLIC_BIND=true, and COMFY_AUTO_ENABLE_CORS_ON_REMOTE=true by default for remote compatibility.\n\n## Preview Method (Automatic and Manual Download)\n\nIf .env uses COMFYUI_PREVIEW_METHOD=taesd (or auto), you can download TAESD decoders:\n\n- automatically during setup when COMFY_PREVIEW_AUTO_SETUP=true\n- manually with the preview setup script\n\nManual commands:\n\n```bash\n./scripts/setup-preview-method.sh\n./scripts/setup-preview-method.sh --method taesd\n./scripts/setup-preview-method.sh --method taesd --force\n```\n\nThe script downloads:\n\n- taesd_decoder.pth\n- taesdxl_decoder.pth\n- taesd3_decoder.pth\n- taef1_decoder.pth\n\nDestination:\n\n```text\ncomfyui/models/vae_approx\n```\n\n## Available Scripts\n\n```bash\n# Initial setup / update ComfyUI\n./scripts/run-comfyui.sh setup\n\n# Start ComfyUI locally\n./scripts/run-comfyui.sh start\n\n# Start with extra args (example)\n./scripts/run-comfyui.sh start -- --disable-auto-launch\n\n# Manually install custom node dependencies\n./scripts/run-comfyui.sh deps\n\n# Manually download preview decoders\n./scripts/run-comfyui.sh preview\n./scripts/run-comfyui.sh preview --method taesd --force\n\n# Download models (Hugging Face / CivitAI)\n./scripts/model-download.sh --provider huggingface --model-dir checkpoints --repo owner/repo --file model.safetensors\n./scripts/model-download.sh --provider civitai --model-dir loras --model-id 12345\n./scripts/run-comfyui.sh model-download --provider civitai --model-dir checkpoints --model-id 12345\n\n# Download Z-Image model sets\n./scripts/downloads/download-z-image-turbo.sh\n./scripts/downloads/download-z-image-base.sh\n\n# Download LTX-2.3 model set\n./scripts/downloads/download-ltx-2.3.sh\n\n# Download WAN 2.2 model sets\n./scripts/downloads/download-wan-2.2.sh --mode i2v\n./scripts/downloads/download-wan-2.2.sh --mode t2v\n./scripts/downloads/download-wan-2.2.sh --mode all\n\n# Save a workflow to the main workflows directory\n./scripts/workflow-save.sh my_workflow.json\n\n# Save directly to editing\n./scripts/workflow-save.sh --editing my_workflow.json\n\n# Move an existing workflow to editing\n./scripts/workflow-move-to-edit.sh my_workflow.json\n```\n\n## Migration from the Previous Docker Workflow\n\nRemoved from this repository:\n\n- docker-compose.yml\n- docker-compose.gpu.yml\n- Dockerfile\n- entrypoint, preflight, verify-*, and compose helper scripts\n\nThe current workflow is fully local to simplify custom node installation and maintenance.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacecodee%2Fcomfyui-docker-compose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacecodee%2Fcomfyui-docker-compose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacecodee%2Fcomfyui-docker-compose/lists"}