AI integration: getting started

AI integration is available starting with Freeplane version 1.13.1.

Configure AI in Preferences

Open AI Preferences from the AI panel toolbar burger menu, then configure the AI options.

Required user input:

  • For OpenRouter:
    • AI OpenRouter key
  • For Gemini:
    • AI Gemini key
  • For Ollama:
    • set AI Ollama service address (for example http://localhost:11434 or your remote endpoint URL).
    • optional: set AI Ollama API key when your Ollama endpoint requires token authentication.

Notes for Ollama:

  • Ollama is available only when AI Ollama service address is set.
  • When AI Ollama API key is non-empty, Freeplane sends Authorization: Bearer <key> for Ollama chat and model discovery requests.

If configuration is missing, chat shows: No AI provider is configured.

Send your first AI chat message

  1. Open the AI panel.
  2. Type a request in the input area.
  3. Use Send or press Command/Ctrl + Enter to start the request.
  4. Use Cancel to stop an active request.

Helpful chat controls:

  • New chat: start a clean live chat.
  • Chats: open the chat list dialog.
  • Manage profiles: open profile management.
  • AI profile: shows or selects the active profile.

Next steps