Repository navigation
Troubleshooting
eduardoabreu81 edited this page Nov 6, 2026
·
1 revision
The extension explains what is wrong instead of failing silently. Its messages appear in Forge's result area and in the console, as one line starting with [Idol] or IdolError. Find yours below.
| Console message | What to do |
|---|---|
[Idol] native backend enabled (torch ...) |
All good. |
[Idol] This Forge Neo is too old for the extension... |
Forge Neo lacks something the extension needs, listed below the message. Nothing was changed. Update Forge Neo (git pull on the neo branch) and restart. |
[Idol] failed to enable, Forge Neo is unchanged: followed by an error |
Forge Neo keeps working without Idol. Report it with the error. |
Idol native controls were not found... |
The panel could not attach to Forge's controls. Update Forge Neo and restart. |
| Message or symptom | What to do |
|---|---|
| The Idol panel does not appear | It lives in img2img, and only while an Idol checkpoint is selected. |
Idol needs ...: select them under VAE / Text Encoder. |
The message names what is missing. See Models. |
Selected Idol component is unavailable... |
A selected file is gone. Refresh the model list. |
Forge did not load the Idol model... |
Check the VAE / Text Encoder selection and the console for an earlier error. |
| Message or symptom | What to do |
|---|---|
Idol makes an object from a picture: use the img2img tab... |
Idol has no txt2img. Generate your picture there, then send it to img2img. |
Add an input image for Idol in img2img... |
Drop a picture into the img2img tab. |
Tick at least one file type under Save as. |
Open Save as and tick a file type. |
Idol currently supports Batch Count = 1. |
Set Batch Count to 1. |
Idol has no inpainting... |
Use the regular img2img input, not the inpaint tabs. |
Disable variation seed and seed resize for Idol. |
Turn off the seed's Extra options. |
Idol found no object in the input image... |
The picture's alpha channel is empty, or the background removal found nothing. Try a simpler background. |
Could not download ... |
No internet, or the download failed. The message gives the link and the folder to put the file in by hand. |
Idol sampling produced NaN or Inf values... |
Try the Euler sampler and the default settings. |
| A strange object | Look at the gallery: it shows what the model saw. A bad cut-out shows there. Use a plainer background, or a PNG with transparency. |
| The object has a very different shape from behind | That side is the model's guess. Try another seed, or a three-quarter view. |
| Message or symptom | What to do |
|---|---|
| The viewer stays black | If the img2img tab was hidden during the generation, press Rotate and save with the angles at 0. After a rotation the object can also take a few seconds to appear, faint at first. |
| The object is sideways | Models do not always put the front towards the viewer. Use Idol rotate Y. |
| The object is upside down in another program |
.ply is y-down and .spz y-up, as their conventions go. Use Idol rotate X at 180, or the other file. |
Generate an object first... |
The rotation applies to the last object of this session: Forge forgets it when it restarts. |
The last object is no longer there... |
Its file was deleted or moved. Generate it again. |
Idol could not make a mesh... |
There was no solid surface to extract. The .ply and .spz are still saved. |
| A rough or blurred mesh | The mesh is a draft, and faces drawn with lines suffer most. Try Idol mesh resolution or Idol mesh smoothing, or use the .ply or .spz. |
Open an issue with the message, the console output and your Forge Neo version.
Idol for Forge Neo
Using it
Reference
