/obsidian-ai-tools

Adding powerful semantic search, generative answers, and other AI tools to Obsidian, using Supabase + OpenAI.

Primary LanguageTypeScriptMIT LicenseMIT

Obsidian AI

Talk to an LLM clone of yourself, or even host it for everyone else to talk to

This plugin aims to bring every useful AI-powered feature to Obsidian while maintaining the self-hosted ethos. Right now, it offers powerful semantic search and generative question answering over your notes. In the future, I plan to add features like note auto-tagging, faster hybrid search etc.

Powered by Supabase Vector and the OpenAI API.

Features

  • ✅ Semantic search over your notes
  • ✅ Talk to your notes
  • ✅ Simple unified UI

Wishlist

  • Public endpoint for others to talk to selected notes (working on it!)
  • Suggest related notes to link to the active note
  • Suggest tags for note
  • Hybrid search with keyword and semantic matching
  • Natural language querying of frontmatter with SQL translation
  • (and I dream of more and more!)

Demo

Installation

This plugin uses Supabase, and you can choose if you prefer a remote project or a local one. I will provide instructions for setting it up either way. I recommend the remote approach just for the sake of convenience and reliability.

Pre-requisites

  1. A Supabase project. You can set up by going to the Supabase Dashboard and following the instructions.
  2. An OpenAI Account and API Key. You can register for one on the OpenAI website.

Instructions

Set up the Supabase Project

Using Supabase CLI

  1. Install Supabase CLI by following these instructions
  2. Login to Supabase CLI 
    supabase login
  3. Clone this repo 
    git clone git@github.com:solderneer/obsidian-ai.git
cd obsidian-ai
  4. Link to remote project 
    supabase link --project-ref <project-id>
# You can get <project-id> from your project's dashboard URL: https://supabase.com/dashboard/project/<project-id>
  5. Deploy database 
    supabase db push

Manually

  1. Navigate to the SQL Editor inside the project dashboard.
  2. In another tab, navigate to the SQL migrations in this repo and copy them into a new query.
  3. Run the query and verify if the Table Editor now shows two tables, document and document_section.

Install the plugin

  1. Go to the latest release, and download main.js, manifest.json and styles.css.
  2. Copy them into your obsidian vault in a new folder, VaultFolder/.obsidian/plugins/obsidian-id/.
  3. Restart Obsidian if it was already running.
  4. Now, go to the Obsidian Settings and navigate to the Community Plugins tab.
  5. You should see Obsidian AI in the list, click the toggle to enable.

Setup the plugin

  1. Navigate to the Obsidian AI Settings under the Obsidian Settings.
  2. Go to the previously set up Supabase Project, and under Project Settings, find the Supabase URL and the Supabase Service Role Key.
  3. Copy the Supabase URL and Service Role Key into the appropriate inputs in the Obsidian AI Settings
  4. Next, go to your OpenAI Account, retrieve your API Key and copy it into the appropriate input in the Obsidian AI Settings.
  5. You should see a status indicator saying, ✨ [AI] Ready. This means everything is working!
  6. At this point, remember to configure the Excluded Directories, for any directories you don't want to index.
  7. Press Cmd/Ctrl + p and search for Obsidian AI: Refresh Index. Executing that will calculate all the embeddings and index them in the Supabase database. This can take a while, so please be patient.
  8. When it's completed, the status indicator should switch back to ✨ [AI] Ready and the Supabase Tables should be populated with entries!

Usage

  1. Press Cmd/Ctrl + p and search for Obsidian AI: AI Search.
  2. Select the command and the unified UI modal will appear!

Using a local Supabase project instead

Pre-requisites

  1. A local Supabase environment. Follow the instructions on the Supabase website

Instructions

Instead of the Supabase instructions above, do the following instead.

  1. Clone this repo and navigate to it

    git clone git@github.com:solderneer/obsidian-ai.git
cd obsidian-ai

  2. Start Supabase locally (you need docker as well)

    supabase start

  3. Apply migrations to set up table

    supabase db reset