· HELP ·

Troubleshooting

The most common install and runtime errors, with exact fixes. Hit the chatbot for anything not listed.

Install errors

npm install fails with "Python not found"

Some dependencies need Python for native builds. Windows: install Python 3.11 and re-run. Mac: brew install python.

ollama pull stalls at 0%

Usually firewall or VPN. Disable VPN, try again. If Corporate firewall, ask IT to whitelist *.ollama.com.

"port 5055 already in use"

Another process is on that port. Find and kill, or use a different port: node server.js 5056.

OAuth errors

Google: "app not verified / access blocked"

You haven't added yourself as a test user. Go to Google Auth Platform → Audience → Test users → Add.

Google: "redirect_uri_mismatch"

You created a Web app client instead of Desktop. Create a new OAuth client with type = Desktop app.

Meta: "Can't load URL"

Redirect URI isn't in the Meta app's Valid OAuth Redirects. Add https://www.facebook.com/connect/login_success.html in Facebook Login settings, and add facebook.com to App Domains in Basic Settings.

Meta: /me/accounts returns empty

Missing business_management scope. Re-run Graph Explorer and check that permission during auth. Also confirm your user is an admin on the Page + the Page's Business Portfolio.

Runtime errors

Ollama: "model 'yorkis-brain' not found"

The custom models aren't built on your install. They're aliases. The router resolves them to qwen3.5:9b — make sure that's pulled: ollama pull qwen3.5:9b.

"ENOSPC: no space left"

Disk full from Ollama models. Free 20 GB, or move Ollama models: OLLAMA_MODELS=D:/ollama env var.

Command Deck shows 0 agents

You're on the wrong client. Click the correct tenant tab at the top. Or the clients/ folder is missing — restore from git.

FB post: HTTP 190 "Session has expired"

Page token expired (rare — they're ~14 months). Re-run Graph Explorer for a new short-lived token, then node meta.js refresh <new-token>.

Still stuck?