readme and github job
This commit is contained in:
1 parent
1215ae89fd
commit
d5120276a9
3 files changed
+136
-6
No files matched your search
@@ -0,0 +1,75 @@
|
||||
# ComfyUI for Framework Desktop AI MAX
|
||||
|
||||
A containerized setup for running [ComfyUI](https://github.com/comfyanonymous/ComfyUI) on the Framework Desktop AI MAX with AMD Ryzen AI MAX (Strix Halo) and integrated Radeon graphics.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Framework Desktop AI MAX
|
||||
- Docker with Compose plugin
|
||||
- ROCm-compatible kernel and drivers
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. **Build and start the container:**
|
||||
|
||||
```bash
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
2. **Access the UI:**
|
||||
|
||||
Open your browser and navigate to `http://localhost:8188`
|
||||
|
||||
3. **View logs:**
|
||||
|
||||
```bash
|
||||
docker compose logs -f comfyui
|
||||
```
|
||||
|
||||
4. **Stop the container:**
|
||||
|
||||
```bash
|
||||
docker compose down
|
||||
```
|
||||
|
||||
## Directory Structure
|
||||
|
||||
- `models/` — Place your model files here (checkpoints, VAE, LoRAs, etc.)
|
||||
- `output/` — Generated images and videos are saved here
|
||||
|
||||
## Environment Variables
|
||||
|
||||
The Containerfile sets several ROCm-specific environment variables for Strix Halo compatibility:
|
||||
|
||||
| Variable | Value | Description |
|
||||
| -------------------------- | --------------------------- | -------------------------------------------------------- |
|
||||
| `HSA_OVERRIDE_GFX_VERSION` | `11.5.1` | Forces ROCm to recognize gfx1151 (Strix Halo) |
|
||||
| `HSA_ENABLE_SDMA` | `0` | Disables System DMA engine to avoid compatibility issues |
|
||||
| `ROCBLAS_USE_HIPBLASLT` | `1` | Enables optimized BLAS library for better performance |
|
||||
| `PYTORCH_HIP_ALLOC_CONF` | `expandable_segments:False` | Uses simpler memory allocation for stability |
|
||||
|
||||
## Included Custom Nodes
|
||||
|
||||
- [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager) — Node management and installation
|
||||
- [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper) — WAN 2.1 video generation
|
||||
- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite) — Video utilities
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Segmentation faults during model loading
|
||||
|
||||
Ensure the ROCm base image version matches the PyTorch ROCm wheels. Mismatched versions cause ABI incompatibilities.
|
||||
|
||||
### GPU not detected
|
||||
|
||||
Verify that `/dev/kfd` and `/dev/dri` are accessible and your user is in the `video` and `render` groups:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG video,render $USER
|
||||
```
|
||||
|
||||
Log out and back in for the group changes to take effect.
|
||||
|
||||
### Performance issues
|
||||
|
||||
If using `HIP_LAUNCH_BLOCKING=1` for debugging, remember to remove it for normal use — it forces synchronous execution and significantly reduces performance.
|
||||
Reference in new issue
Block a user