Obsidian Smart Composer

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

Install Smart Composer

AVENTAIL / OBSIDIAN

Install Smart Composer

1 / 8

Full view

Obsidian download page

The download button is below the introduction. Choose the appropriate platform for your computer.

Find the section

Download and platform options

The outlined area is shown close up on the next slide.

Close-up

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.

Slide 04

Enable community plugins

In Obsidian, open Settings → Community plugins. If restricted mode is enabled, choose Turn on community plugins.

Slide 05

Browse plugins

Choose Browse to open the community plugin catalogue.

Slide 06

Find Smart Composer

Search for Smart Composer and select the plugin by Heesu Suh (glowingjade).

Slide 07

Install Smart Composer

Open the plugin page and choose Install.

Slide 08

Enable the plugin

Choose Enable when installation finishes. Smart Composer will appear in the settings sidebar.

Slide 1 of 8: Obsidian download page.

Obsidian download and plugin-installation screenshots from the original guide. Use the arrows or progress marks to move between slides.

AVENTAIL / OBSIDIAN

Install Smart Composer

1 / 8

Full view

Obsidian download page

The download button is below the introduction. Choose the appropriate platform for your computer.

Find the section

Download and platform options

The outlined area is shown close up on the next slide.

Close-up

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.

Slide 04

Enable community plugins

In Obsidian, open Settings → Community plugins. If restricted mode is enabled, choose Turn on community plugins.

Slide 05

Browse plugins

Choose Browse to open the community plugin catalogue.

Slide 06

Find Smart Composer

Search for Smart Composer and select the plugin by Heesu Suh (glowingjade).

Slide 07

Install Smart Composer

Open the plugin page and choose Install.

Slide 08

Enable the plugin

Choose Enable when installation finishes. Smart Composer will appear in the settings sidebar.

Slide 1 of 8: Obsidian download page.

Read the plugin installation steps

1. Download Obsidian 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).
4. Select Install, then Enable.

Connect your model

AVENTAIL / OBSIDIAN

Connect Smart Composer to Link

1 / 10

Full view

Model Serving in Control

Open Serving, then expand API Usage to find the local connection examples.

Find the section

Local API Usage

The outlined area is shown close up on the next slide.

Close-up

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.

Slide 04

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.

Slide 05

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.

Slide 06

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.

Slide 07

Choose the chat model

In Chat settings, select your configured Chat model. Applying edits is a separate capability; configure it only when needed.

Slide 08

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.

Slide 09

Send a message

Check the selected model in the chat panel and send a short prompt without attaching notes.

Slide 10

Review the answer

Check the reply before adding a small note as context. Chat, edits and embeddings need separate checks.

Slide 1 of 10: Model Serving in Control.

Current Control endpoint capture and the original Smart Composer screenshots. Use your own model ID and port. Use the arrows or progress marks to move between slides.

AVENTAIL / OBSIDIAN

Connect Smart Composer to Link

1 / 10

Full view

Model Serving in Control

Open Serving, then expand API Usage to find the local connection examples.

Find the section

Local API Usage

The outlined area is shown close up on the next slide.

Close-up

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.

Slide 04

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.

Slide 05

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.

Slide 06

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.

Slide 07

Choose the chat model

In Chat settings, select your configured Chat model. Applying edits is a separate capability; configure it only when needed.

Slide 08

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.

Slide 09

Send a message

Check the selected model in the chat panel and send a short prompt without attaching notes.

Slide 10

Review the answer

Check the reply before adding a small note as context. Chat, edits and embeddings need separate checks.

Slide 1 of 10: Model Serving in Control.

Read the Smart Composer settings

Use the Smart Composer plugin 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 and leave it serving.
2. Install and enable 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.

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.