Troubleshooting

Command Not Found

Problem: forge: command not found after installation.

Solutions:

1. macOS/Linux: Add Forge to your PATH:
   bashCopy

   echo 'export PATH="$PATH:$HOME/.forge/bin"' >> ~/.bashrc
   source ~/.bashrc
2. Windows: Restart your terminal, or manually add %USERPROFILE%\.forge\bin to your User PATH
3. For Zsh users, use ~/.zshrc instead of ~/.bashrc

macOS Gatekeeper Warning

Problem: "Cannot be opened because the developer cannot be verified"

Solution:

xattr -d com.apple.quarantine ~/.forge/bin/forge

Permission Denied

Problem: Permission errors on macOS/Linux.

Solution:

chmod +x ~/.forge/bin/forge

npm Install Fails

Problem: EACCES permission error with npm.

Solutions:

1. Use sudo: sudo npm install -g @rightnow/forge-cli
2. Or use the curl installer instead (recommended):
   bashCopy

   curl -fsSL https://releases.rightnowai.co/forge/install.sh | bash

Not Authenticated Error

Problem: "Not authenticated" when running commands.

Solution: Sign in first:

forge login

Browser Doesn't Open

Problem: Browser doesn't open automatically during login.

Solutions:

1. Copy the URL from the terminal and open it manually
2. Complete sign-in in your browser
3. If auto-detection times out, copy the short code and enter it in the terminal

Token Expired

Problem: Authentication errors after being logged in.

Solution: Re-authenticate:

forge logout
forge login

Backend Unreachable

Problem: "Backend unreachable" or connection errors.

Solutions:

1. Check your internet connection
2. Run forge health to verify backend status
3. Check if your firewall is blocking connections
4. Wait a few minutes if backend is under maintenance

Timeout Errors

Problem: Operations timing out.

Solution: Increase the timeout:

forge config set api.timeout 60000

No Valid Kernels Found

Problem: AI couldn't generate a working kernel.

Solutions:

1. Use quality mode for more attempts: forge optimize --quality
2. Try Triton format (often easier): forge optimize --format triton
3. Check the task with forge browse --task <id>

Low Speedup Results

Problem: Optimization results are slower than expected.

Solutions:

1. Run longer optimization: forge optimize --quality --no-early-stop
2. Some tasks use torch.compile() as baseline which is harder to beat
3. Try targeting a specific GPU: forge optimize --gpu H100

Optimization Takes Too Long

Problem: Optimization is running for too long.

Solution: Use turbo mode:

forge optimize --turbo

Insufficient Credits

Problem: "Insufficient credits" error.

Solutions:

1. Check your balance: forge credits
2. Purchase more credits at dashboard.rightnowai.co/billing

Credits Not Updating

Problem: Credit balance seems incorrect.

Solution: Refresh your session:

forge logout
forge login
forge credits