Fuser

Troubleshooting

This guide helps you diagnose and fix common issues in Fuser. When something isn't working, start with these quick checks to identify the problem.

Quick Diagnostics

Node Borders: A red border means a node has an error. An animated purple border means it's processing.
Connections: A dashed or red line indicates a connection problem.
API Keys: Check Settings → API Keys. Are all your required provider keys configured and valid?
Provider Status: Check the status pages for your AI providers (e.g., Fal, OpenAI) to see if they are having an outage.

:::details My node won't execute or shows an error.

Check API Key: Does the node require an API key? Ensure it's correctly set up in your settings and that your provider account has enough credits.
Check Inputs: Are all required input sockets (sockets without a default value) connected? Is the input data in the correct format?
Check Rate Limits: Have you made too many requests to the provider in a short period? Wait a few minutes and try again.
Check Provider-Specific Errors: The AI model itself might have rejected the input. Look for messages about prompt length, content filters, or unsupported features. :::

:::details I can't connect two nodes.

Check Compatibility: Data flows from an output socket (right side) to an input socket (left side). You can only connect sockets of compatible data types (e.g., matching colors).
Check Node State: You cannot connect to a node that is currently executing. Wait for it to finish processing. :::

:::details Data isn't updating in downstream nodes.

Check for Errors Upstream: A single error in one node will stop the entire downstream flow. Look for a node with a red border and fix the issue there first.
Try Manual Execution: Select the node that isn't updating and click the Execute button (▶️) in the toolbar to force it and its dependencies to run. :::

:::details Fuser is slow or crashing.

Check File Sizes: Large media files (>50MB) can cause performance problems. Try optimizing or resizing your media before importing.
Simplify Your Workflow: Very complex flows with hundreds of nodes can slow down the interface. Consider breaking your work into smaller, more focused flows.
Check Browser: Ensure you are on the latest version of a modern browser like Chrome or Firefox. Close unnecessary tabs to free up memory. :::

Test Small: Before running a complex or expensive workflow, test the logic with a simple, low-cost input.
Document Your Work: Use text nodes to leave notes for yourself or your team about how a workflow is supposed to function.
Save Regularly: Fuser saves automatically, but creating named versions of important workflows is a good practice.
Monitor Credits: Keep an eye on your credit balance with your AI providers to avoid interruptions.

If your issue isn't covered here, the Fuser community is the best place to get help.

Join our Discord: For real-time help from the community and the Fuser team.
Check GitHub Issues: See if your issue has already been reported or submit a new bug report.

After resolving your issues, get back to building.