Added Documentation

This commit is contained in:
jerryipsum
2025-04-09 20:29:36 +01:00
parent 13487afa05
commit 980d82b9ee
4 changed files with 121 additions and 4 deletions
+6 -3
View File
@@ -21,9 +21,10 @@ class LoadImageFromHttpURL:
def load_image(self, image_url: str):
try:
response = requests.get(image_url)
response = requests.get(image_url, stream=True)
response.raise_for_status()
image = Image.open(io.BytesIO(response.content)).convert("RGB")
image = Image.open(response.raw).convert("RGB")
image_np = np.array(image).astype(np.float32) / 255.0
image_tensor = torch.from_numpy(image_np).unsqueeze(0)
@@ -31,4 +32,6 @@ class LoadImageFromHttpURL:
return (image_tensor,)
except Exception as e:
print(f"Failed to load image from URL: {e}")
return (torch.zeros(1, 512, 512, 3),) # fallback black image
# Return a black image if loading fails
return (torch.zeros(1, 512, 512, 3),)
+110 -1
View File
@@ -1 +1,110 @@
# ComfyUI_LoadImageFromHttpURL
# ComfyUI_LoadImageFromHttpURL
### 🧩 Load Image from HTTP URL – Custom Node for ComfyUI
By @jerrywap
[![GitHub stars](https://img.shields.io/github/stars/jerrywap/ComfyUI_LoadImageFromHttpURL?style=social)](https://github.com/jerrywap/ComfyUI_LoadImageFromHttpURL/stargazers)
![ComfyUI Node](screenshot.png)
---
## 🔍 Description
**Load Image from HTTP URL** is a lightweight but powerful custom node for ComfyUI that allows you to **fetch images directly from a remote URL** and use them in your workflows without manual uploads or preprocessing.
Instead of uploading an image file manually, you can pass a publicly accessible image URL — and the node will handle downloading, decoding, and converting it into an image tensor compatible with ComfyUI.
This is especially useful when you're:
- ⚙️ Building **ComfyUI as an API service**
- 📡 Receiving image URLs from client apps, webhooks, or JSON payloads
- 🌐 Working with **dynamic content** from external APIs or cloud storage
By skipping the file transfer step, you reduce friction, improve performance, and make your workflows more automation-friendly.
---
## ✨ Features
- 📡 Downloads an image from an HTTP/HTTPS URL
- 📷 Converts it to a proper image tensor (`IMAGE`) for ComfyUI
- 🧼 Includes graceful fallback (returns a blank black image on error)
- ✅ Supports JPEG, PNG, WebP, etc. (any format supported by Pillow)
---
## 🧩 Node Info
- **Name:** `Load Image from HTTP URL`
- **Class:** `LoadImageFromHttpURL`
- **Category:** `jerrywap/loaders`
- **Input:**
- `image_url` (STRING): Image address (e.g. https://placehold.co/400)
- **Output:**
- `IMAGE`: ComfyUI image tensor
---
## 🔧 Installation
1. Clone this repo into your `ComfyUI/custom_nodes` directory:
```
cd /workspace/ComfyUI/custom_nodes
git clone https://github.com/yourusername/ComfyUI_LoadImageFromHttpURL.git
cd ComfyUI_LoadImageFromHttpURL
```
2. Install dependencies:
This node requires the following Python packages:
- `requests`
- `Pillow`
- `numpy`
- `torch`
If you're not sure whether you have them installed, you can simply run:
```
bash install.sh
```
Or, alternatively:
```
pip install -r requirements.txt
```
> ✅ **Note:** If you already have these packages installed (e.g., through your ComfyUI or Python environment), you **do not need to run** the installation steps.
3. Restart ComfyUI or click the **Reload Custom Nodes** button in the UI (if available).
---
## 📤 Example Usage
Use this node to pull images from:
- Web apps or APIs
- Unsplash/image hosting services
- Placeholder tools
Example input:
```
https://placehold.co/400
```
---
## 🧑‍💻 Contributing
Contributions welcome! Submit a PR or open an issue if you’d like to improve this.
---
## 📄 License
MIT License — free to use, modify, and distribute.
[![GitHub stars](https://img.shields.io/github/stars/jerrywap/ComfyUI_LoadImageFromHttpURL?style=social)](https://github.com/jerrywap/ComfyUI_LoadImageFromHttpURL/stargazers)
+5
View File
@@ -0,0 +1,5 @@
requests
Pillow
numpy
torch
opencv-python
BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB