obsidian-plugin/djayatillake_obsidian-llm-tagger
1
0
Fork 0
mirror of https://github.com/djayatillake/obsidian-llm-tagger.git synced 2026-07-22 05:37:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
18 commits 1 branch 4 tags 67 KiB
TypeScript 90%
CSS 8%
JavaScript 2%
Find a file
djayatillake 576462c544 Update README with v1.1 features and changelog
2025-03-21 19:05:09 +00:00
.gitignore Remove main.js from tracking and update gitignore 2025-01-23 23:04:57 +00:00
esbuild.config.mjs initial 2025-01-23 22:53:43 +00:00
icon.svg initial 2025-01-23 22:53:43 +00:00
LICENSE pre-publishing details 2025-01-23 22:57:12 +00:00
main.ts persist tags, dont tag open file and tag on close 2025-03-21 19:03:50 +00:00
manifest.json removing mention of js file from manifest.json 2025-02-24 17:50:28 +00:00
package-lock.json initial 2025-01-23 22:53:43 +00:00
package.json initial 2025-01-23 22:53:43 +00:00
README.md Update README with v1.1 features and changelog 2025-03-21 19:05:09 +00:00
styles.css changing to not change standard progress bar and have one dedicated to llm tagger 2025-02-24 17:53:39 +00:00
test.md initial 2025-01-23 22:53:43 +00:00
tsconfig.json initial 2025-01-23 22:53:43 +00:00

README.md

Obsidian LLM Tagger Plugin

This plugin uses Ollama to automatically tag your Obsidian notes using large language models running locally on your machine.

Features

  • 🤖 Uses local LLMs via Ollama for privacy and speed
  • 🏷️ Automatically generates relevant tags for your notes
  • 📝 Creates brief summaries with tags while preserving original content
  • ⚡ Auto-tagging option for new and modified files
  • 🎯 Customizable tag list for focused tagging
  • 🔄 Smart processing that avoids re-tagging unchanged files
  • 🚫 Exclude specific files or folders from tagging using patterns
  • 📝 Skip auto-tagging for files you're currently editing
  • 🔄 Auto-tag files when you close them
  • 💾 Persistent tag storage between Obsidian sessions

Prerequisites

  1. Obsidian v1.0.0 or higher
  2. Ollama installed and running locally

Installation

From Obsidian Community Plugins

  1. Open Obsidian Settings
  2. Go to Community Plugins
  3. Search for "LLM Tagger"
  4. Click Install, then Enable

Manual Installation

  1. Download the latest release
  2. Extract files to your vault's .obsidian/plugins/obsidian-llm-tagger/ directory
  3. Reload Obsidian
  4. Enable the plugin in Community Plugins settings

Usage

  1. Click the robot icon in the left sidebar to open the tagger panel
  2. Select your preferred Ollama model (e.g., llama2, mistral)
  3. Enter your desired tags, separated by commas
  4. Click "Start Tagging" to process your notes

Auto-tagging

Enable auto-tagging in the plugin settings to automatically tag new or modified notes.

Exclusion Patterns

You can exclude specific files or folders from being tagged by adding patterns in the plugin settings:

  • Enter exact filenames (e.g., daily.md)
  • Enter folder paths (e.g., templates/)
  • Use wildcards (e.g., *.excalidraw, meeting-notes/*)

Configuration

  • Model Selection: Choose any Ollama model you have installed
  • Default Tags: Set your commonly used tags
  • Auto-tagging: Toggle automatic tagging of new/modified files
  • Exclude Patterns: Specify files or folders to exclude from tagging

Changelog

v1.1 (March 21, 2025)

  • Added exclusion patterns to skip specific files/folders from tagging
  • Skip auto-tagging for files that are currently being edited
  • Auto-tag files when they are closed (after editing)
  • Persist tags between Obsidian sessions
  • Improved user experience with automatic tag saving

v1.0 (Initial Release)

  • Basic tagging functionality with Ollama integration
  • Auto-tagging for new and modified files
  • Tag customization and model selection

Development

# Clone the repository
git clone https://github.com/yourusername/obsidian-llm-tagger.git

# Install dependencies
npm install

# Build
npm run build

License

MIT License - see LICENSE for details