Skip to content

Conversation

@TimPietruskyRunPod
Copy link
Contributor

@TimPietruskyRunPod TimPietruskyRunPod commented Dec 3, 2025

Motivation

  • User-reported issue: Models on network volumes were not being detected by ComfyUI
  • Root cause: Not a bug—users were placing models in incorrect directory structure (/runpod-volume/checkpoints/ instead of /runpod-volume/models/checkpoints/)
  • Solution: Add opt-in diagnostics and clear documentation so users can self-diagnose via NETWORK_VOLUME_DEBUG environment variable

Issues closed

fixes #91

- Check if extra_model_paths.yaml exists at /comfyui/
- Print yaml content to logs
- Check if /runpod-volume is mounted
- List contents of /runpod-volume and /runpod-volume/models

This helps debug why models on network volumes might not be detected.
- add logging to check if extra_model_paths.yaml exists and print content
- add logging to check if /runpod-volume is mounted and list contents
- replaces bash echo statements that were not captured by runpod serverless

this diagnostic output will appear in runpod logs to help debug why
models on network volumes are not being detected by comfyui.
- diagnostics now run on every request instead of module import time
- use print() instead of logger for better stdout capture
- this ensures diagnostic output appears in runpod serverless logs
…ooting

- Add NETWORK_VOLUME_DEBUG environment variable (default: false)
- Create comprehensive diagnostic function that shows:
  - Configuration file status
  - Network volume mount status
  - Directory structure validation
  - Model files found (with size and extension validation)
  - Expected structure guidance when issues found
- Document network volume configuration in docs/configuration.md
  - Expected directory structure
  - Supported file extensions by model type
  - Step-by-step debugging instructions
  - Common issues and solutions

Resolves user reports of models not being detected on network volumes.
Root cause: user configuration issues (wrong directory structure or
missing file extensions), not a bug in worker-comfyui.
- move NETWORK_VOLUME_DEBUG from debugging to logging configuration table
- remove redundant TIP block about COMFY_LOG_LEVEL
- fix customization.md tip block syntax to proper github admonition format
- correct network volume paths in customization guide:
  - clarify /runpod-volume mount point for serverless endpoints
  - update example paths to show /runpod-volume/models/ structure
  - fix note block syntax to proper github admonition format
  - add links to network-volumes.md for detailed structure and debugging
  - mention s3-compatible api as upload option
- move network volume diagnostic functions from handler.py to src/network_volume.py
- remove obsolete bash diagnostics from src/start.sh (replaced by python diagnostics)
- update handler.py to import diagnostics from network_volume module
- update dockerfile to include src/network_volume.py in image build
- reduces handler.py size by ~150 lines for better maintainability
@TimPietruskyRunPod TimPietruskyRunPod changed the title fix: network volume model paths feat: debug "network volume model paths" issues Dec 3, 2025
Copy link

@Madiator2011Work Madiator2011Work left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@TimPietruskyRunPod TimPietruskyRunPod merged commit d0f6992 into main Dec 3, 2025
4 checks passed
@TimPietruskyRunPod TimPietruskyRunPod deleted the fix/network-volume-model-paths branch December 3, 2025 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

How to find Ultralytics detector models on network volume?

4 participants