Restore download API and add frontend extension for Missing Models dialog

Backend changes:
- Restored model download API endpoints in server.py
- Supports download, pause, resume, cancel operations
- Tracks download progress and history

Frontend extension package:
- Created standalone extension for ComfyUI frontend repository
- Automatically adds "Download" buttons to Missing Models dialog
- Includes repository of known model URLs (SDXL, SD1.5, VAEs, LoRAs, etc.)
- Shows real-time download progress in button (percentage)
- Supports custom URLs for unknown models
- "Download All" button for bulk downloads

The extension works with the separated frontend repository structure.
When missing models are detected, users can now download them directly
from the dialog without manually finding and moving files.

Installation instructions included in frontend_extensions/missingModelsDownloader/README.md

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
fragmede 2025-09-27 02:49:03 -07:00
parent 803c5039ac
commit 04556a53f4
No known key found for this signature in database
4 changed files with 642 additions and 0 deletions

View File

@ -0,0 +1,99 @@
# Missing Models Downloader for ComfyUI
This extension adds automatic download functionality to ComfyUI's "Missing Models" dialog, allowing users to download missing models directly from the interface with a single click.
## Features
- **Automatic Download Buttons**: Adds a "Download" button next to each missing model in the dialog
- **Known Model Repository**: Pre-configured URLs for popular models (SDXL, SD1.5, VAEs, LoRAs, ControlNet, etc.)
- **Custom URL Support**: Prompts for URL if model is not in the repository
- **Real-time Progress**: Shows download percentage directly in the button
- **Bulk Downloads**: "Download All" button for multiple missing models
- **Smart Detection**: Automatically detects model type and places files in correct folders
## Installation
### For ComfyUI Frontend Repository
If you're using the separate ComfyUI frontend repository:
1. Clone the frontend repository:
```bash
git clone https://github.com/Comfy-Org/ComfyUI_frontend.git
cd ComfyUI_frontend
```
2. Copy this extension to the extensions folder:
```bash
cp -r path/to/frontend_extensions/missingModelsDownloader web/extensions/
```
3. Build and run the frontend as usual
### For ComfyUI with Built-in Frontend
If your ComfyUI still has the built-in frontend:
1. Copy the extension files to ComfyUI's web extensions:
```bash
cp -r frontend_extensions/missingModelsDownloader ComfyUI/web/extensions/core/
```
2. Restart ComfyUI
## Backend Requirements
The backend (ComfyUI server) must have the model downloader API endpoints installed. These are included in the `easy-download` branch or can be added manually:
1. Ensure `app/model_downloader.py` exists
2. Ensure `comfy_config/download_config.py` exists
3. Ensure `server.py` includes the download API endpoints
## How It Works
1. When ComfyUI shows the "Missing Models" dialog, the extension automatically detects it
2. Each missing model gets a "Download" button
3. For known models, clicking downloads immediately from the pre-configured source
4. For unknown models, you'll be prompted to enter the download URL
5. Download progress is shown as a percentage in the button
6. Once complete, the model is ready to use (refresh the node to see it)
## Supported Model Sources
The extension includes pre-configured URLs for models from:
- **HuggingFace**: Stable Diffusion models, VAEs, LoRAs
- **GitHub**: Upscale models (ESRGAN, RealESRGAN)
- **ComfyAnonymous**: Flux text encoders
## Configuration
Edit `missingModelsDownloader.js` to add more models to the repository:
```javascript
this.modelRepositories = {
"checkpoints": {
"your_model.safetensors": "https://url/to/model"
}
}
```
## API Endpoints
The extension uses these backend API endpoints:
- `POST /api/models/download` - Start a download
- `GET /api/models/download/{task_id}` - Check download status
- `POST /api/models/download/{task_id}/cancel` - Cancel a download
## Troubleshooting
If the download buttons don't appear:
1. Check the browser console for errors
2. Ensure the backend API endpoints are working: `curl http://localhost:8188/api/models/downloads`
3. Verify the extension is loaded (should see `[MissingModelsDownloader]` in console)
## License
MIT

View File

@ -0,0 +1,435 @@
import { app } from "/scripts/app.js";
import { api } from "/scripts/api.js";
// Missing Models Dialog Enhancer - Adds download buttons to the missing models dialog
app.registerExtension({
name: "Comfy.MissingModelsDownloader",
async setup() {
console.log("[MissingModelsDownloader] Extension loading...");
// Model repository with known URLs
this.modelRepositories = {
"checkpoints": {
"sd_xl_base_1.0.safetensors": "https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_base_1.0.safetensors",
"sd_xl_refiner_1.0.safetensors": "https://huggingface.co/stabilityai/stable-diffusion-xl-refiner-1.0/resolve/main/sd_xl_refiner_1.0.safetensors",
"v1-5-pruned-emaonly.safetensors": "https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors",
"v1-5-pruned.safetensors": "https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors",
"v2-1_768-ema-pruned.safetensors": "https://huggingface.co/stabilityai/stable-diffusion-2-1/resolve/main/v2-1_768-ema-pruned.safetensors"
},
"vae": {
"vae-ft-mse-840000-ema-pruned.safetensors": "https://huggingface.co/stabilityai/sd-vae-ft-mse-original/resolve/main/vae-ft-mse-840000-ema-pruned.safetensors",
"sdxl_vae.safetensors": "https://huggingface.co/stabilityai/sdxl-vae/resolve/main/sdxl_vae.safetensors",
"sdxl.vae.safetensors": "https://huggingface.co/stabilityai/sdxl-vae/resolve/main/sdxl_vae.safetensors"
},
"clip": {
"clip_l.safetensors": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/clip_l.safetensors",
"t5xxl_fp16.safetensors": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp16.safetensors",
"t5xxl_fp8_e4m3fn.safetensors": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp8_e4m3fn.safetensors"
},
"loras": {
"lcm-lora-sdv1-5.safetensors": "https://huggingface.co/latent-consistency/lcm-lora-sdv1-5/resolve/main/pytorch_lora_weights.safetensors",
"lcm-lora-sdxl.safetensors": "https://huggingface.co/latent-consistency/lcm-lora-sdxl/resolve/main/pytorch_lora_weights.safetensors"
},
"controlnet": {
"control_sd15_canny.pth": "https://huggingface.co/lllyasviel/ControlNet/resolve/main/models/control_sd15_canny.pth",
"control_sd15_openpose.pth": "https://huggingface.co/lllyasviel/ControlNet/resolve/main/models/control_sd15_openpose.pth",
"control_sd15_depth.pth": "https://huggingface.co/lllyasviel/ControlNet/resolve/main/models/control_sd15_depth.pth",
"control_v11p_sd15_canny.pth": "https://huggingface.co/lllyasviel/ControlNet-v1-1/resolve/main/control_v11p_sd15_canny.pth",
"control_v11f1p_sd15_depth.pth": "https://huggingface.co/lllyasviel/ControlNet-v1-1/resolve/main/control_v11f1p_sd15_depth.pth"
},
"upscale_models": {
"RealESRGAN_x4plus.pth": "https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth",
"RealESRGAN_x4plus_anime_6B.pth": "https://github.com/xinntao/Real-ESRGAN/releases/download/v0.2.2.4/RealESRGAN_x4plus_anime_6B.pth",
"realesr-general-x4v3.pth": "https://github.com/xinntao/Real-ESRGAN/releases/download/v0.2.5.0/realesr-general-x4v3.pth",
"4x-UltraSharp.pth": "https://huggingface.co/lokCX/4x-Ultrasharp/resolve/main/4x-UltraSharp.pth"
},
"unet": {
"flux1-dev.safetensors": "https://huggingface.co/black-forest-labs/FLUX.1-dev/resolve/main/flux1-dev.safetensors",
"flux1-schnell.safetensors": "https://huggingface.co/black-forest-labs/FLUX.1-schnell/resolve/main/flux1-schnell.safetensors"
}
};
// Active downloads tracking
this.activeDownloads = new Map();
// Hook into the app to monitor for missing models dialog
this.setupDialogMonitoring();
},
setupDialogMonitoring() {
const self = this;
// Monitor DOM mutations for dialog creation
const observer = new MutationObserver((mutations) => {
mutations.forEach((mutation) => {
mutation.addedNodes.forEach((node) => {
if (node.nodeType === 1) { // Element node
// Check for dialog containers
self.checkForMissingModelsDialog(node);
}
});
});
});
// Start observing
observer.observe(document.body, {
childList: true,
subtree: true
});
console.log("[MissingModelsDownloader] Dialog monitoring active");
},
checkForMissingModelsDialog(element) {
// Look for the missing models dialog by its content
const isDialog = element.classList && (
element.classList.contains('p-dialog') ||
element.classList.contains('comfy-modal') ||
element.tagName === 'DIALOG'
);
if (!isDialog && element.querySelector) {
const dialogs = element.querySelectorAll('dialog, .p-dialog, .comfy-modal');
dialogs.forEach(dialog => this.checkForMissingModelsDialog(dialog));
return;
}
const textContent = element.textContent || "";
// Check for missing models dialog indicators
if (textContent.includes("Missing Models") ||
textContent.includes("When loading the graph") ||
textContent.includes("models were not found")) {
console.log("[MissingModelsDownloader] Found missing models dialog");
// Add a small delay to ensure dialog is fully rendered
setTimeout(() => {
this.enhanceMissingModelsDialog(element);
}, 100);
}
},
enhanceMissingModelsDialog(dialogElement) {
// Don't enhance twice
if (dialogElement.dataset.enhancedWithDownloads) {
return;
}
dialogElement.dataset.enhancedWithDownloads = "true";
// Find model entries in the dialog
const modelEntries = this.findModelEntries(dialogElement);
if (modelEntries.length === 0) {
console.log("[MissingModelsDownloader] No model entries found in dialog");
return;
}
console.log(`[MissingModelsDownloader] Found ${modelEntries.length} missing models`);
// Add download button to each model
modelEntries.forEach(entry => {
this.addDownloadButton(entry);
});
// Add "Download All" button if multiple models
if (modelEntries.length > 1) {
this.addDownloadAllButton(dialogElement, modelEntries);
}
},
findModelEntries(dialogElement) {
const entries = [];
// Look for list items containing model paths
const listItems = dialogElement.querySelectorAll('li, .model-item, [class*="missing"]');
listItems.forEach(item => {
const text = item.textContent || "";
// Pattern: folder.filename or folder/filename
if (text.match(/\w+[\.\/]\w+/)) {
entries.push({
element: item,
text: text.trim()
});
}
});
// Also check for any divs or spans that might contain model names
if (entries.length === 0) {
const textElements = dialogElement.querySelectorAll('div, span, p');
textElements.forEach(elem => {
const text = elem.textContent || "";
if (text.match(/\w+\.\w+/) && !elem.querySelector('button')) {
// Check if this looks like a model filename
const parts = text.split(/[\.\/]/);
if (parts.length >= 2 && this.looksLikeModelName(parts[parts.length - 1])) {
entries.push({
element: elem,
text: text.trim()
});
}
}
});
}
return entries;
},
looksLikeModelName(filename) {
const modelExtensions = ['safetensors', 'ckpt', 'pt', 'pth', 'bin'];
const lower = filename.toLowerCase();
return modelExtensions.some(ext => lower.includes(ext));
},
addDownloadButton(entry) {
const { element, text } = entry;
// Parse model info from text
const modelInfo = this.parseModelInfo(text);
if (!modelInfo) return;
// Create download button
const btn = document.createElement('button');
btn.textContent = 'Download';
btn.style.cssText = `
margin-left: 10px;
padding: 4px 12px;
background: #4CAF50;
color: white;
border: none;
border-radius: 4px;
cursor: pointer;
font-size: 12px;
font-weight: 500;
`;
// Check if we have a known URL
const knownUrl = this.getKnownUrl(modelInfo.folder, modelInfo.filename);
if (knownUrl) {
btn.style.background = '#2196F3';
btn.title = 'Download from known source';
}
btn.onclick = () => this.startDownload(modelInfo, btn);
element.appendChild(btn);
entry.button = btn;
},
parseModelInfo(text) {
// Try different patterns
const patterns = [
/(\w+)\.(\w+(?:\.\w+)*)/, // folder.filename
/(\w+)\/(\w+(?:\.\w+)*)/, // folder/filename
/^(\w+(?:\.\w+)*)$/ // just filename
];
for (const pattern of patterns) {
const match = text.match(pattern);
if (match) {
if (match.length === 2) {
// Just filename, try to guess folder
return {
folder: this.guessFolder(match[1]),
filename: match[1]
};
} else {
return {
folder: match[1],
filename: match[2]
};
}
}
}
return null;
},
guessFolder(filename) {
const lower = filename.toLowerCase();
if (lower.includes('vae')) return 'vae';
if (lower.includes('lora')) return 'loras';
if (lower.includes('control')) return 'controlnet';
if (lower.includes('upscale') || lower.includes('esrgan')) return 'upscale_models';
if (lower.includes('clip')) return 'clip';
if (lower.includes('unet') || lower.includes('flux')) return 'unet';
return 'checkpoints';
},
getKnownUrl(folder, filename) {
const repo = this.modelRepositories[folder];
if (repo && repo[filename]) {
return repo[filename];
}
// Try alternate folders
const alternateFolders = {
'text_encoders': 'clip',
'diffusion_models': 'unet'
};
const altFolder = alternateFolders[folder];
if (altFolder) {
const altRepo = this.modelRepositories[altFolder];
if (altRepo && altRepo[filename]) {
return altRepo[filename];
}
}
return null;
},
async startDownload(modelInfo, button) {
const knownUrl = this.getKnownUrl(modelInfo.folder, modelInfo.filename);
let url = knownUrl;
if (!url) {
// Prompt for custom URL
url = prompt(
`Enter download URL for:\n${modelInfo.filename}\n\n` +
`Model type: ${modelInfo.folder}\n\n` +
`You can find models at:\n` +
`• HuggingFace: https://huggingface.co/models\n` +
`• CivitAI: https://civitai.com/models`
);
if (!url || !url.trim()) return;
url = url.trim();
}
// Update button state
button.textContent = 'Starting...';
button.disabled = true;
button.style.background = '#FF9800';
try {
const response = await api.fetchApi("/api/models/download", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
url: url,
model_type: modelInfo.folder,
filename: modelInfo.filename
})
});
const data = await response.json();
if (response.ok) {
console.log(`[MissingModelsDownloader] Started download: ${data.task_id}`);
this.activeDownloads.set(data.task_id, { button, modelInfo });
this.monitorDownload(data.task_id, button);
} else {
button.textContent = 'Failed';
button.style.background = '#F44336';
button.disabled = false;
alert(`Download failed: ${data.error || 'Unknown error'}`);
}
} catch (error) {
console.error('[MissingModelsDownloader] Download error:', error);
button.textContent = 'Error';
button.style.background = '#F44336';
button.disabled = false;
}
},
async monitorDownload(taskId, button) {
const checkStatus = async () => {
try {
const response = await api.fetchApi(`/api/models/download/${taskId}`);
const status = await response.json();
if (!response.ok) {
button.textContent = 'Failed';
button.style.background = '#F44336';
button.disabled = false;
this.activeDownloads.delete(taskId);
return;
}
switch (status.status) {
case 'completed':
button.textContent = '✓ Downloaded';
button.style.background = '#4CAF50';
button.disabled = true;
this.activeDownloads.delete(taskId);
// Refresh model lists
if (app.refreshComboInNodes) {
app.refreshComboInNodes();
}
break;
case 'downloading':
const progress = Math.round(status.progress || 0);
button.textContent = `${progress}%`;
button.style.background = '#2196F3';
setTimeout(checkStatus, 2000);
break;
case 'failed':
button.textContent = 'Failed';
button.style.background = '#F44336';
button.disabled = false;
this.activeDownloads.delete(taskId);
break;
default:
button.textContent = status.status;
setTimeout(checkStatus, 2000);
}
} catch (error) {
console.error('[MissingModelsDownloader] Status check error:', error);
button.textContent = 'Error';
button.style.background = '#F44336';
button.disabled = false;
this.activeDownloads.delete(taskId);
}
};
checkStatus();
},
addDownloadAllButton(dialogElement, modelEntries) {
// Find dialog footer or create button container
let buttonContainer = dialogElement.querySelector('.p-dialog-footer, .dialog-footer');
if (!buttonContainer) {
buttonContainer = document.createElement('div');
buttonContainer.style.cssText = `
padding: 15px;
border-top: 1px solid #444;
text-align: center;
margin-top: 15px;
`;
dialogElement.appendChild(buttonContainer);
}
const downloadAllBtn = document.createElement('button');
downloadAllBtn.textContent = `Download All (${modelEntries.length} models)`;
downloadAllBtn.style.cssText = `
padding: 8px 16px;
background: #FF9800;
color: white;
border: none;
border-radius: 4px;
cursor: pointer;
font-weight: bold;
margin: 0 5px;
`;
downloadAllBtn.onclick = () => {
modelEntries.forEach(entry => {
if (entry.button && !entry.button.disabled) {
entry.button.click();
}
});
downloadAllBtn.disabled = true;
downloadAllBtn.textContent = 'Downloads Started';
};
buttonContainer.appendChild(downloadAllBtn);
}
});

View File

@ -0,0 +1,11 @@
{
"name": "comfyui-missing-models-downloader",
"version": "1.0.0",
"description": "Adds download buttons to the Missing Models dialog in ComfyUI",
"main": "missingModelsDownloader.js",
"author": "ComfyUI",
"license": "MIT",
"comfyui": {
"extension_type": "web"
}
}

View File

@ -35,6 +35,7 @@ from comfy_api.internal import _ComfyNodeInternal
from app.user_manager import UserManager
from app.model_manager import ModelFileManager
from app.custom_node_manager import CustomNodeManager
from app.model_downloader import model_downloader, ModelType
from typing import Optional, Union
from api_server.routes.internal.internal_routes import InternalRoutes
from protocol import BinaryEventTypes
@ -789,6 +790,102 @@ class PromptServer():
return web.Response(status=200)
@routes.post("/models/download")
async def start_model_download(request):
"""Start a new model download."""
try:
json_data = await request.json()
url = json_data.get("url")
model_type = json_data.get("model_type")
filename = json_data.get("filename")
metadata = json_data.get("metadata", {})
if not url:
return web.json_response({"error": "URL is required"}, status=400)
# Parse model type if provided as string
if model_type and isinstance(model_type, str):
try:
model_type = ModelType[model_type.upper()]
except KeyError:
model_type = None
# Create download task
task_id = model_downloader.create_download_task(
url=url,
model_type=model_type,
filename=filename,
metadata=metadata
)
# Start download
model_downloader.start_download(task_id)
# Return task ID and initial status
status = model_downloader.get_download_status(task_id)
return web.json_response(status)
except ValueError as e:
return web.json_response({"error": str(e)}, status=400)
except Exception as e:
logging.error(f"Error starting download: {e}")
return web.json_response({"error": "Failed to start download"}, status=500)
@routes.get("/models/download/{task_id}")
async def get_download_status(request):
"""Get status of a specific download."""
task_id = request.match_info.get("task_id")
status = model_downloader.get_download_status(task_id)
if status is None:
return web.json_response({"error": "Download task not found"}, status=404)
return web.json_response(status)
@routes.get("/models/downloads")
async def get_all_downloads(request):
"""Get status of all downloads."""
downloads = model_downloader.get_all_downloads()
return web.json_response(downloads)
@routes.post("/models/download/{task_id}/pause")
async def pause_download(request):
"""Pause a download."""
task_id = request.match_info.get("task_id")
success = model_downloader.pause_download(task_id)
if not success:
return web.json_response({"error": "Failed to pause download"}, status=400)
return web.json_response({"success": True})
@routes.post("/models/download/{task_id}/resume")
async def resume_download(request):
"""Resume a paused download."""
task_id = request.match_info.get("task_id")
success = model_downloader.resume_download(task_id)
if not success:
return web.json_response({"error": "Failed to resume download"}, status=400)
return web.json_response({"success": True})
@routes.post("/models/download/{task_id}/cancel")
async def cancel_download(request):
"""Cancel a download."""
task_id = request.match_info.get("task_id")
success = model_downloader.cancel_download(task_id)
if not success:
return web.json_response({"error": "Failed to cancel download"}, status=400)
return web.json_response({"success": True})
@routes.get("/models/download/history")
async def get_download_history(request):
"""Get download history."""
return web.json_response(model_downloader.download_history)
async def setup(self):
timeout = aiohttp.ClientTimeout(total=None) # no timeout
self.client_session = aiohttp.ClientSession(timeout=timeout)