Skip to main content

Obsidian

Obsidian integration

Combine your notes with local, private AI by integrating Loc.ai with Obsidian.

What is Obsidian?​

Obsidian is a writing app based on local Markdown files, linking, and a rich plugin ecosystem — often used as a "second brain".

Why Loc.ai + Obsidian?​

  • Privacy — Notes and LLM traffic stay on your devices when you use local serving
  • Offline-friendly — Work without cloud AI dependencies once models are deployed

Prerequisites​

  1. Loc.ai Link installed and device registered — registration guide
  2. Link running on the device
  3. Obsidian installed

Step 1: Upload a language model​

Loc.ai supports GGUF language models — see Supported models.

  1. ML MODELS → Upload ML Model
  2. Upload a GGUF file or choose a shared language model
  3. Set Model Type to Language Models
Upload time depends on model size and bandwidth.

Step 2: Deploy​

  1. In ML Models, Action on your model
  2. Select an online device with enough storage
  3. Deploy

Step 3: Serve​

  1. Click Serve Model
  2. Choose a port (default 8100)
info

Use the resulting base URL (e.g. http://127.0.0.1:8100/v1) in plugins.

Step 4: Enable community plugins​

Settings → Community plugins → turn on community plugins (exit Restricted Mode).

Back up your vault before enabling community plugins.

Use case: Smart Composer​

Install: Smart Composer from community plugins.

Configure:

  • Add custom provider → OpenAI Compatible
  • Base URL: http://<YOUR_DEVICE_IP>:<PORT> (per plugin docs)
  • Add models and set chat/apply models
tip

Multiple models on different ports → multiple providers.