Skip to content

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
JoramMillenaar committed Nov 27, 2024
1 parent a674b8c commit bd104c7
Showing 1 changed file with 16 additions and 42 deletions.
58 changes: 16 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,39 @@
# Related Notes

**Related Notes Finder** is an Obsidian plugin that intelligently suggests related notes by their meaning, helping you uncover hidden connections and insights within your knowledge vault. Built with privacy in mind, this plugin operates entirely on your local device—your data stays private and secure.
Find notes with similar meaning intelligently, helping you uncover hidden connections and insights within your Obsidian vault. Built with privacy in mind, this plugin operates entirely on your local device—your data stays private and secure.

<details>
<summary>Note From the Creator</summary>
This plugin excites me. For me, Obsidian’s greatest value lies in reducing the strain of writing. The whole Zettelkasten approach—don’t worry about structure, just focus on relationships—is an amazing method to capture thoughts and build a personal knowledge base. However, there’s still one significant pain point in my writing routine: relating notes. It’s challenging to remember existing notes (especially when you have over a thousand) and decide how to connect them. This plugin aims to ease that burden by presenting an overview of the most closely related notes in meaning—all while staying local and on-device, a core Obsidian principle that I deeply value.
</details>
![Screenshot](https://github.com/JoramMillenaar/obsidian-related-notes/raw/master/example.gif)


<details>
<summary>The Technology Behind Driving It</summary>
I won’t delve into too much detail or documentation here, but I can’t help but rave about the incredible technology that powers this plugin. At its core is an AI that transforms sentences and paragraphs into representations that encapsulate not just the words but the meaning. These “meaning” representations are stored and used to calculate the closest neighbors in a multidimensional “meaning space.” This space is high-dimensional, enabling it to capture the many nuances of meaning embedded in language. It’s truly fascinating technology, offering immense potential to enhance both our minds and knowledge vaults!
∂</details>

---

# 🚧 **Under Construction: Plugin in Development** 🚧

> ### ⚠️ **Notice: This Plugin is a Work in Progress!** ⚠️
>
> **This README outlines the intended functionality for the Related Notes Finder plugin, but the plugin is not yet fully operational as described.**
>
> I'm actively working to bring these features to life. Contributions are encouraged and appreciated! Feel free to dive in, experiment, and help shape the final product.
---

## Features

- **Fully Local and Private**: Your notes and data are never sent outside your device. All processing is done locally to ensure complete privacy.
- **Automatic Note Linking**: The plugin analyzes your notes' content to suggest contextually related notes, without requiring manual tags or links.
- **Easy Navigation**: Quickly access related notes in the sidebar to deepen your understanding and make connections across your knowledge.

## Installation

1. Open Obsidian and go to **Settings > Community plugins**.
2. Click on **Browse** and search for "Related Notes Finder."
3. Click **Install** and then **Enable** the plugin.
## Settings

Alternatively, you can clone this repository and place it in your Obsidian plugins folder:
```bash
git clone https://github.com/JoramMillenaar/related-notes.git
```
Go to **Settings > Related Notes Finder** to customize the plugin’s behavior:
- **Number of Related Notes**: Set how many notes to display as related.
- **Plugin Server Port** (advanced): The plugin spins up a small local server for all the AI tricks. This determines which port to use for the local communication.

## Usage

1. With the plugin enabled, open any note in your Obsidian vault.
2. Use the command palette (press `Ctrl/Cmd + P`) and type "Show Related Notes" to view suggestions based on the current note's content.
3. Suggested notes will appear in the sidebar (or your preferred location), allowing you to explore related ideas and make new connections.
## Usage

## Configuration
1. When the plugin is initially enabled, it will automatically start forming the relations in the background. You can see the progress on the bottom right.
2. After that is finished, open a note and find a new tab in the leaf of your note with a telescope icon. Here you should see the top-related notes as represented by the percentage of overlap in meaning.
3. You can press on any of the notes in the list to navigate to.
4. If you created a new note or you edited your current note, be sure to press the refresh button to update the relations. This will also let the other notes relate to your new changes.

Go to **Settings > Related Notes Finder** to customize the plugin’s behavior:
- **Number of Related Notes**: Set how many notes to display as related.
### Commands
- Use the command palette (press `Ctrl/Cmd + P`) and type "Refresh relations of all notes" to reset all the relations. This could be useful if the relations seemed to have been corrupted (the plugin is still in development!).

## Privacy and Security

One of Obsidian's greatest strengths is its commitment to data ownership and privacy. This plugin upholds that philosophy by making privacy its highest priority. All processing and note relations happen entirely on your device, ensuring your notes stay yours—always.

**Related Notes Finder** is built with privacy at its core:
- **Local Processing**: Every analysis and operation occurs directly on your device. Your notes never leave your vault.
- **No Third-Party Dependencies**: The plugin requires no internet access or external APIs, providing a fully private and secure experience.
- **No Third-Party Dependencies**: Once installed, the plugin requires no internet access or external APIs, providing a fully private and secure experience.

## Development

Expand All @@ -83,9 +57,9 @@ For more information on developing Obsidian plugins, check out the [Obsidian Plu

## Contributing

Contributions are always welcome! If you have ideas for improvements or new features, please open an issue or submit a pull request to start a discussion.
Contributions are very welcome! If you have ideas for improvements or new features, please open an issue or submit a pull request to start a discussion. I have plenty of ideas on powerful features to implement in the future, but I can use some help in getting the plugin to a stable point first.

This plugin relies on [relate-text](https://github.com/JoramMillenaar/relate-text) for much of its core logic. Contributions to this library are equally encouraged and will directly enhance the functionality of the plugin.
At the momentm, this plugin relies on [relate-text](https://github.com/JoramMillenaar/relate-text) for much of its core logic. Contributions to this library are equally encouraged and will directly enhance the functionality of the plugin.

### TODO
Here are the current development goals for the plugin:
Expand Down

0 comments on commit bd104c7

Please sign in to comment.