# Obsidian Smart Composer

Source: [https://docs.aventail.co.uk/docs/integration/obsidian](https://docs.aventail.co.uk/docs/integration/obsidian)

Use **Smart Composer** by Heesu Suh (glowingjade) with a tested local model.

## Install Smart Composer

### Install Smart Composer

Obsidian download and plugin-installation screenshots from the original guide.

1.  **Download Obsidian**
    
    Download Obsidian for your operating system, install it and open a vault. If it is already installed, continue to the next slide.
    
    The original screenshot shows Windows; choose the download for your own platform.
    
    [Screenshot: Download and platform options — close-up from Obsidian download page.](https://docs.aventail.co.uk/img/Obsidianstep_3.png)
    
2.  **Enable community plugins**
    
    In Obsidian, open Settings → Community plugins. If restricted mode is enabled, choose Turn on community plugins.
    
    [Screenshot: Obsidian Community plugins settings with Turn on community plugins highlighted.](https://docs.aventail.co.uk/img/obsidianstep__4.png)
    
3.  **Browse plugins**
    
    Choose Browse to open the community plugin catalogue.
    
    [Screenshot: Obsidian Community plugins settings with Browse highlighted.](https://docs.aventail.co.uk/img/obsidianstep__5.png)
    
4.  **Find Smart Composer**
    
    Search for Smart Composer and select the plugin by Heesu Suh (glowingjade).
    
    [Screenshot: Community plugin search results showing Smart Composer by Heesu Suh.](https://docs.aventail.co.uk/img/obsidianstep__6.png)
    
5.  **Install Smart Composer**
    
    Open the plugin page and choose Install.
    
    [Screenshot: Smart Composer plugin page with its Install button highlighted.](https://docs.aventail.co.uk/img/obsidianstep__7.png)
    
6.  **Enable the plugin**
    
    Choose Enable when installation finishes. Smart Composer will appear in the settings sidebar.
    
    [Screenshot: Installed Smart Composer plugin with the Enable button highlighted.](https://docs.aventail.co.uk/img/obsidianstep__8.png)
    

**Read the plugin installation steps**

1.  [Download Obsidian](https://obsidian.md/download) for your operating system, install it and open a vault. Skip this if Obsidian is already installed.
2.  Open **Settings → Community plugins**. If needed, choose **Turn on community plugins**.
3.  Choose **Browse**, search for **Smart Composer**, and select the plugin by **Heesu Suh** ([glowingjade](https://github.com/glowingjade/obsidian-smart-composer)).
4.  Select **Install**, then **Enable**.

## Connect your model

### Connect Smart Composer to Link

Current Control endpoint capture and the original Smart Composer screenshots. Use your own model ID and port.

1.  **Copy the model endpoint**
    
    In Control, start serving your model and open API Usage. Use its host and port with /v1 as the base URL for Smart Composer.
    
    On the same machine as Link, this walkthrough uses http://127.0.0.1:8100/v1.
    
    [Screenshot: Local API Usage — close-up from Model Serving in Control.](https://docs.aventail.co.uk/img/guides/context/serving.png)
    
2.  **Add a custom provider**
    
    In Smart Composer settings, choose Add custom provider. Use OpenAI Compatible and your Link base URL ending in /v1. The connection values are below.
    
    [Screenshot: Smart Composer settings with Add custom provider highlighted.](https://docs.aventail.co.uk/img/obsidianstep__9.png)
    
3.  **Open the chat-model form**
    
    In Smart Composer settings, scroll to the end of Chat Models and select Add custom model, just above Embedding Models.
    
    [Screenshot: Smart Composer model list with Add custom model highlighted above Embedding Models.](https://docs.aventail.co.uk/img/Obsidianstep11.png)
    
4.  **Add a chat model**
    
    Select your provider and enter the exact model ID from /v1/models. Give this chat configuration a recognisable ID, then choose Add.
    
    Provider and model names in the screenshot are examples.
    
    [Screenshot: Add Custom Chat Model dialog with ID, Provider ID, Model Name and Prompt Level fields.](https://docs.aventail.co.uk/img/Obsidianstep12.png)
    
5.  **Choose the chat model**
    
    In Chat settings, select your configured Chat model. Applying edits is a separate capability; configure it only when needed.
    
    [Screenshot: Smart Composer Chat settings with the configured Chat model and Apply model selectors.](https://docs.aventail.co.uk/img/Obsidian-step14.png)
    
6.  **Open the chat panel**
    
    Close settings and select the Smart Composer wand icon in Obsidian’s left ribbon. The chat panel opens on the right.
    
    [Screenshot: Obsidian left ribbon with the Smart Composer wand icon highlighted.](https://docs.aventail.co.uk/img/Obsidian-step14__.png)
    
7.  **Send a message**
    
    Check the selected model in the chat panel and send a short prompt without attaching notes.
    
    [Screenshot: Smart Composer chat composer with its configured model and message field.](https://docs.aventail.co.uk/img/Obsidian-step_15_.png)
    
8.  **Review the answer**
    
    Check the reply before adding a small note as context. Chat, edits and embeddings need separate checks.
    
    [Screenshot: Smart Composer displaying a generated course-description answer and Copy control.](https://docs.aventail.co.uk/img/Obsidian-step_16_.png)
    

**Read the Smart Composer settings**

Use the [Smart Composer plugin](https://github.com/glowingjade/obsidian-smart-composer) by glowingjade. The instructions below concern this plugin; other Obsidian AI plugins have different settings.

## Add your local model

1.  [Test your model's API](https://docs.aventail.co.uk/docs/getting-started/run-first-interface) and leave it serving.
2.  [Install and enable Smart Composer](https://docs.aventail.co.uk/docs/integration/obsidian#install-smart-composer) if you have not already done so.
3.  Open Smart Composer's settings and add a custom provider:

| Field | Value on the same machine as Link |
| --- | --- |
| Provider ID | `locai` |
| Provider type | OpenAI Compatible |
| Base URL | `http://127.0.0.1:8100/v1` |
| API key | `locai-local` for the tested unauthenticated endpoint |

4.  Scroll to **Chat Models → Add custom model**, just above **Embedding Models**. Choose provider `locai` and the exact model ID returned by `/v1/models`, for example `Gemma 4 (X-Small)`. Give the configuration a recognisable ID such as `locai-chat`, then select **Add**.
5.  Select that model under **Chat model**. Close settings and select the **Smart Composer wand icon** in the left ribbon to open the chat panel.
6.  Check the selected model and send a short message without attaching notes.

Use your actual serving port and any authentication required by your endpoint. The example key is not a Control credential.

These fields follow Smart Composer's [custom-provider configuration](https://github.com/glowingjade/obsidian-smart-composer/wiki/1.4-Advanced-Configuration).

## Add notes after chat works

Try one small note and inspect the response. Chat, applying edits and generating embeddings are separate capabilities; a working chat model does not automatically provide the other two.

If basic chat fails, check the provider type, the `/v1` suffix and the model ID before troubleshooting note size. See [connection troubleshooting](https://docs.aventail.co.uk/docs/troubleshooting/common-issues).