Reference

Troubleshooting

config.yaml not found

Pass an explicit config path:

rays --config /absolute/path/to/config.yaml

Ollama not reachable

Default Ollama URL is http://localhost:11434. Start the daemon before selecting the local provider in the launcher.

Gemini / API keys

Prefer environment variables: GEMINI_API_KEY or GOOGLE_API_KEY. Keys are intentionally not persisted in YAML.

rays command not found

  • pipx — run pipx ensurepath, open a new shell.
  • pip — ensure your Python Scripts / bin directory is on PATH.

MCP servers not connecting

  • Backend not running — many MCP servers are bridges; the underlying app must also be up.
  • command not on PATH when launched from a GUI — use the absolute path from which <command>.
  • Two clients at once — don't run the same MCP server in RAYS and another client simultaneously.