diff --git a/gpt4all-bindings/python/docs/assets/obsidian_adding_collection.png b/gpt4all-bindings/python/docs/assets/obsidian_adding_collection.png new file mode 100644 index 00000000..6bc52976 Binary files /dev/null and b/gpt4all-bindings/python/docs/assets/obsidian_adding_collection.png differ diff --git a/gpt4all-bindings/python/docs/assets/obsidian_docs.png b/gpt4all-bindings/python/docs/assets/obsidian_docs.png new file mode 100644 index 00000000..292c9b72 Binary files /dev/null and b/gpt4all-bindings/python/docs/assets/obsidian_docs.png differ diff --git a/gpt4all-bindings/python/docs/assets/obsidian_response.png b/gpt4all-bindings/python/docs/assets/obsidian_response.png new file mode 100644 index 00000000..9ae8219d Binary files /dev/null and b/gpt4all-bindings/python/docs/assets/obsidian_response.png differ diff --git a/gpt4all-bindings/python/docs/assets/obsidian_sources.png b/gpt4all-bindings/python/docs/assets/obsidian_sources.png new file mode 100644 index 00000000..e81b41e3 Binary files /dev/null and b/gpt4all-bindings/python/docs/assets/obsidian_sources.png differ diff --git a/gpt4all-bindings/python/docs/assets/osbsidian_user_interaction.png b/gpt4all-bindings/python/docs/assets/osbsidian_user_interaction.png new file mode 100644 index 00000000..acbf828c Binary files /dev/null and b/gpt4all-bindings/python/docs/assets/osbsidian_user_interaction.png differ diff --git a/gpt4all-bindings/python/docs/gpt4all_desktop/cookbook/use-local-ai-models-to-privately-chat-with-Obsidian.md b/gpt4all-bindings/python/docs/gpt4all_desktop/cookbook/use-local-ai-models-to-privately-chat-with-Obsidian.md new file mode 100644 index 00000000..2660c38d --- /dev/null +++ b/gpt4all-bindings/python/docs/gpt4all_desktop/cookbook/use-local-ai-models-to-privately-chat-with-Obsidian.md @@ -0,0 +1,109 @@ +# Using GPT4All to Privately Chat with your Obsidian Vault + +Obsidian for Desktop is a powerful management and note-taking software designed to create and organize markdown notes. This tutorial allows you to sync and access your Obsidian note files directly on your computer. By connecting it to LocalDocs, you can integrate these files into your LLM chats for private access and enhanced context. + +## Download Obsidian for Desktop + +!!! note "Download Obsidian for Desktop" + + 1. **Download Obsidian for Desktop**: + - Visit the [Obsidian website](https://obsidian.md) and create an account account. + - Click the Download button in the center of the homepage + - For more help with installing Obsidian see [Getting Started with Obsidian](https://help.obsidian.md/Getting+started/Download+and+install+Obsidian) + + 2. **Set Up Obsidian**: + - Launch Obsidian from your Applications folder (macOS), Start menu (Windows), or equivalent location (Linux). + - On the welcome screen, you can either create a new vault (a collection of notes) or open an existing one. + - To create a new vault, click Create a new vault, name your vault, choose a location on your computer, and click Create. + + + 3. **Sign in and Sync**: + - Once installed, you can start adding and organizing notes. + - Choose the folders you want to sync to your computer. + + + +## Connect Obsidian to LocalDocs + +!!! note "Connect Obsidian to LocalDocs" + + 1. **Open LocalDocs**: + - Navigate to the LocalDocs feature within GPT4All. + + + + + +
+ + LocalDocs interface +
+ + 2. **Add Collection**: + - Click on **+ Add Collection** to begin linking your Obsidian Vault. + + + + + +
+ + Screenshot of adding collection +
+ + - Name your collection + + + 3. **Create Collection**: + - Click **Create Collection** to initiate the embedding process. Progress will be displayed within the LocalDocs interface. + + 4. **Access Files in Chats**: + - Load a model to chat with your files (Llama 3 Instruct is the fastest) + - In your chat, open 'LocalDocs' with the button in the top-right corner to provide context from your synced Obsidian notes. + + + + + +
+ + Accessing LocalDocs in chats +
+ + 5. **Interact With Your Notes:** + - Use the model to interact with your files + + + + +
+ + osbsidian user interaction +
+ + + + +
+ + osbsidian GPT4ALL response +
+ + 6. **View Referenced Files**: + - Click on **Sources** below LLM responses to see which Obsidian Notes were referenced. + + + + + +
+ + Referenced Files +
+ +## How It Works + +Obsidian for Desktop syncs your Obsidian notes to your computer, while LocalDocs integrates these files into your LLM chats using embedding models. These models find semantically similar snippets from your files to enhance the context of your interactions. + +To learn more about embedding models and explore further, refer to the [Nomic Python SDK documentation](https://docs.nomic.ai/atlas/capabilities/embeddings). + diff --git a/gpt4all-bindings/python/mkdocs.yml b/gpt4all-bindings/python/mkdocs.yml index 3a698cbc..ea5ecc1c 100644 --- a/gpt4all-bindings/python/mkdocs.yml +++ b/gpt4all-bindings/python/mkdocs.yml @@ -16,6 +16,7 @@ nav: - 'Settings' : 'gpt4all_desktop/settings.md' - 'Cookbook': - 'Local AI Chat with your Google Drive': 'gpt4all_desktop/cookbook/use-local-ai-models-to-privately-chat-with-google-drive.md' + - 'Local AI Chat with your Obsidian Vault': 'gpt4all_desktop/cookbook/use-local-ai-models-to-privately-chat-with-Obsidian.md' - 'Local AI Chat with your OneDrive': 'gpt4all_desktop/cookbook/use-local-ai-models-to-privately-chat-with-One-Drive.md' - 'Python SDK': - 'gpt4all_python/home.md'