User guide

Configuring AI

Open Settings → AI, pick a Provider and a Model, and press Save.

Which model should I pick?

The list is fixed: only models tested against the app. Roughly needs is GPU memory, or system memory without a GPU.

Model Runtime Model key Download Roughly needs
Qwen 2.5 (7B) Ollama qwen2.5:7b 4.7 GB ~8 GB RAM or VRAM
Qwen 2.5 (32B) Ollama qwen2.5:32b 19.9 GB ~24 GB VRAM (or 32 GB RAM) — best quality, slowest
Mistral (7B) Ollama mistral:7b 4.4 GB ~8 GB RAM or VRAM
Gemma 3n (e4B) Ollama gemma3n:e4b 7.5 GB ~6 GB RAM or VRAM — lightest to run, despite the larger download
Gemma 4 (e4B) Ollama gemma4:e4b 9.6 GB ~6 GB RAM or VRAM
Qwen 3.6 (35B-A3B) Ollama qwen3.6:35b-a3b 23.9 GB ~24 GB VRAM (or 32 GB RAM) — reasons before answering; MoE, so faster than its size suggests
Qwen 3.8 (27B) Ollama qwen3.8:27b 17.7 GB ~20 GB VRAM (or 32 GB RAM) — reasons before answering
Muse Glimmer (28B) Ollama muse-glimmer:latest 18.2 GB ~20 GB VRAM (or 32 GB RAM) — reasons before answering
Qwen 2.5 (7B) LM Studio qwen/qwen2.5-7b 4.7 GB ~8 GB RAM or VRAM
Qwen 2.5 (32B) LM Studio qwen/qwen2.5-32b 19.9 GB ~24 GB VRAM (or 32 GB RAM) — best quality, slowest
Mistral (7B) LM Studio mistralai/mistral-7b-instruct-v0.3 4.4 GB ~8 GB RAM or VRAM
Gemma 3n (e4B) LM Studio google/gemma-3n-e4b 4.2 GB ~6 GB RAM or VRAM — lightest option
Gemma 4 (e4B) LM Studio google/gemma-4-e4b 6.3 GB ~6 GB RAM or VRAM
Qwen 3.6 (35B-A3B) LM Studio qwen/qwen3.6-35b-a3b 22.1 GB ~24 GB VRAM (or 32 GB RAM) — reasons before answering; MoE, so faster than its size suggests
Qwen 3.8 (27B) LM Studio qwen/qwen3.8-27b 17.7 GB ~20 GB VRAM (or 32 GB RAM) — reasons before answering
Muse Glimmer (28B) LM Studio meta/muse-glimmer 18.2 GB ~20 GB VRAM (or 32 GB RAM) — reasons before answering
Bonsai (27B) LM Studio prism-ml/bonsai-27b 4.7 GB ~8 GB RAM or VRAM — 27B at 1-bit quantization, so it fits a small card; reasons before answering
Claude Opus 5 Claude (cloud) claude-opus-5 — Nothing — runs on Anthropic's servers; billed by them
Claude Sonnet 5 Claude (cloud) claude-sonnet-5 — Nothing — runs on Anthropic's servers; billed by them
Claude Haiku 4.5 Claude (cloud) claude-haiku-4-5-20251001 — Nothing — runs on Anthropic's servers; billed by them
GPT-5 OpenAI (cloud) gpt-5 — Nothing — runs on OpenAI's servers; billed by them
GPT-5 mini OpenAI (cloud) gpt-5-mini — Nothing — runs on OpenAI's servers; billed by them
GPT-4.1 OpenAI (cloud) gpt-4.1 — Nothing — runs on OpenAI's servers; billed by them

Downloads

The download icon beside Model lists every model: downloading, failed, installed, available. Downloads continue while you use the app.

Using a cloud provider

Claude and OpenAI are optional. When you use one, the map outline, the node you act on and the chat are sent to that provider and billed to your account. The app asks before the first request, and shows a Cloud chip in chat. Your API key is stored encrypted.

API access is billed separately from a Claude or ChatGPT subscription. Add credit first: a key without credit connects, then fails on the first message.

Setting up a Claude API key

  1. Sign in at platform.claude.com and add credit under Settings → Billing.
  2. Settings → API keys → Create key. Scope it to one workspace if asked.
  3. Copy the key (sk-ant-api…, shown once) into API key and press Test connection.

If the test asks for a workspace ID, copy it (wrkspc_…) from Settings → Workspaces in the Console into Workspace ID — or create a key scoped to one workspace. A claude setup-token token does not work here.

Setting up an OpenAI API key

  1. Sign in at platform.openai.com and add credit under Settings → Billing.
  2. API keys → Create new secret key, in the project that has the credit.
  3. Copy the key (sk-, shown once) into API key and press Test connection.

insufficient_quota means that project has no credit left.

Cost and size

For a map that must never leave your device, use Ollama or LM Studio.

Your provider account

MindMap Chat is not affiliated with Anthropic or OpenAI. You use your own account under their terms; billing, quota and support are between you and them. As the Elastic License 2.0 says, the software comes as is, without warranty. Clear conversation deletes a chat on this device only; the provider keeps sent requests under its own retention policy.

Set up Ollama manually

  1. Install it from ollama.com. It listens on http://localhost:11434.
  2. Pull a model by its key from the table, e.g. ollama pull qwen2.5:7b.
  3. Settings → AI → Ollama, pick that model, Save.

Set up LM Studio manually

  1. Install it: Windows winget install -e --id ElementLabs.LMStudio; macOS brew install --cask lm-studio (Apple Silicon); Linux: the AppImage from lmstudio.ai, chmod +x, and sudo apt install libfuse2.
  2. Open LM Studio once — that installs its lms tool, which the app needs.
  3. Download a model (lms get qwen/qwen2.5-7b -y) and start the server (lms server start -p 1234).
  4. Settings → AI → LM Studio, pick that model, Save. The first reply is slow while the model loads.

Share one AI server across your network

Run Ollama or LM Studio on one capable computer and use it from every other device.

On the server:

  1. Make it listen on the network: set OLLAMA_HOST=0.0.0.0 and restart Ollama, or run lms server start --bind 0.0.0.0 -p 1234.
  2. Download the models there.
  3. Open the port — see Opening the port on your firewall.
  4. Note its address, e.g. 192.168.1.50.

On each other device: Settings → AI, the same provider, Base URL http://192.168.1.50:11434/v1 (Ollama) or http://192.168.1.50:1234/v1 (LM Studio). On a phone, enter just 192.168.1.50.

Opening the port on your firewall

The server must listen on the network (above) and the firewall must allow the port: 11434 for Ollama, 1234 for LM Studio. Either missing, the connection just times out.

Neither runtime has a password. Anyone who reaches the port can use it. Allow your local network only, and never forward the port on your router. At your own risk.

Windows — PowerShell as Administrator:

New-NetFirewallRule -DisplayName "Ollama LAN" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 11434 -Profile Private -RemoteAddress LocalSubnet

Linux — sudo ufw allow from 192.168.1.0/24 to any port 11434 proto tcp, then check sudo ufw status.

macOS — the firewall (System Settings → Network → Firewall) works per app. If it is on, run sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add $(which ollama), then the same with --unblockapp. For LM Studio use /Applications/LM Studio.app.

To undo: Remove-NetFirewallRule -DisplayName "Ollama LAN" (Windows), sudo ufw delete <number> from sudo ufw status numbered (Linux), or --blockapp (macOS).

Where your AI requests go

Everything the AI sees goes to the address you set:

Your database encryption does not cover what you send to a remote server.

Article data (ArticleAtlas)

Settings → AI → Article data (ArticleAtlas). When on, the app downloads public, read-only data about scientific articles (titles, abstracts, authors) from articleatlas.org, the same way it downloads an update. It sends no account, no map content and no search text — only requests for files, and articleatlas.org keeps no log of who requested what. Turn it off and the app never connects to articleatlas.org.