Troubleshooting

Download stuck or slow

1. Open Downloads and read the status on the failed or paused row.
2. Choose Check what's wrong when offered. See whether the server answered.
3. Try another network if you can, then retry. Resume works only when the server supports it.
4. If the file is marked unavailable, pick another model. Retrying cannot make an unavailable file ready.

• Check site status
• Choose another model

Hash mismatch

Checked means the downloaded bytes match the expected SHA-256. If the check fails, delete the partial file and download again. If a website link says the file hash does not match, open the model page and start from a fresh link.

• How verification works
• Website open confirm screen

Model too big

If chat stops for memory, accept Switch to a smaller model when offered, or choose a smaller file under Fits my computer in Discover. You can also pair another computer if sharing is set up.

• Memory rules
• Share memory across computers

Firewall or local network

Downloads need outbound HTTPS. Computer sharing needs local network access between paired machines. Allow the app when macOS, Windows or Linux asks.

• Sharing and pairing

macOS will not open

1. Confirm Apple silicon and macOS 11 or later.
2. Drag the app to Applications and open it from there.
3. Re-download the .dmg if it may be incomplete and verify SHA-256 on the download page.
4. Use Open Anyway in Privacy and Security for a trusted test build when macOS offers it.

• Install on Mac

Replies are slow

The first reply waits for the model to load. Smaller models are faster. Choose Stop, then Try again, or switch models if progress stalls.

• Chat basics