The Copilot plugin provides an AI-powered writing assistant that helps users generate ideas, organize notes, and create content. It offers various modes, including Chat mode for conversational writing and Vault QA mode for integrating with Obsidian's note-taking app. The plugin supports multiple models from OpenAI and Azure, allowing users to choose the most suitable one based on their needs. With its user-friendly interface and customization options, the Obsidian plugin is ideal for writers, researchers, and students seeking to streamline their writing process and enhance their productivity.
In this release, multimodal LLMs can see the images in your note context! Official DeepSeek is added as a chat model provider, and streaming of its thinking tokens is supported as well! There are some other usability upgrades and bug fixes as well, check the change log for more details.
Copilot for Obsidian is an open-source LLM interface right inside Obsidian. It has a minimalistic design and is straightforward to use.
My goal is to make it the ultimate AI assistant that truly understands your personal knowledge base while being privacy-focused.
It has a local index that powers the question-answering. Your notes are always stored on your own device and nowhere else! More features are under construction. Stay tuned!
If you enjoy Copilot for Obsidian, please consider sponsoring this project, or donate by clicking the button below. It will help me keep this project going to build toward a privacy-focused AI experience. Thank you!
SPECIAL THANKS TO OUR TOP SPONSORS:
@mikelaaron, @pedramamini, @Arlorean, @dashinja, @azagore, @MTGMAD, @gpythomas, @emaynard, @scmarinelli, @borthwick, @adamhill, @gluecode, @rusi, @timgrote, @JiaruiYu-Consilium, @ddocta, @AMOz1, @chchwy, @pborenstein, @GitTom, @kazukgw, @mjluser1, @joesfer, @rwaal, @turnoutnow-harpreet, @dreznicek, @xrise-informatik, @jeremygentles, @ZhengRui, @bfoujols, @jsmith0475, @pagiaddlemon, @sebbyyyywebbyyy, @royschwartz2, @vikram11, @amiable-dev, @khalidhalim, @DrJsPBs, @chishaku, @Andrea18500, @shayonpal, @rhm2k, @snorcup, @JohnBub, @obstinatelark, @jonashaefele, @vishnu2kmohan
As we are fast approaching the official launch of Copilot Plus, we've revamped the settings page to make it more user-friendly and intuitive. Please share your feedback on the new settings page! We've also implemented a brand new experience for easier inline editing of selected text using Copilot commands such as simplify
, translate
, fix grammar
, etc. You can now select text and see a list of them in your right-click context menu. (Thanks to @Emt-lin and @zeroliu for the contribution!)
We've introduced Relevant Notes in Copilot Chat in the previous release. You can now see the collapsible Relevant Notes section at the top of the chat UI. It uses the same Copilot index you create for Vault QA. "Relevance" is determined by Copilot's own special algorithm based on hybrid search and Obsidian's note graph similarity, it is not just vector similarity. You can clearly see ranking factors such as the level of similarity and whether it has a direct link or backlink to the current note. You can also add any relevant note to chat with one click. The entire feature is developed by our great @zeroliu, one of our top contributors πͺ. Enjoy!
Copilot Plus is a brand new mode that brings powerful agentic capabilities to Obsidian. Think of it as Cursor inside Obsidian but optimized for PKM use cases instead of coding.
Check out the demo video below for the first sneak peak of what Copilot Plus can do. It is under active development so expect more features to come very soon!
[[
and provide the note title./
in the chat input!Chat and Vault QA modes are completely free to use. Copilot Plus is currently in beta, buy now to lock in the lowest price!
OpenAI, Anthropic, Azure OpenAI, Google Gemini, Cohere, OpenRouter, GROQ, and any 3rd Party Models with OpenAI-Compatible API are supported. You can easily add them via Custom Model in Copilot settings.
LM Studio and Ollama are supported for local models. Please check out the super simple setup guide here. Don't forget to flex your creativity in custom prompts using local models!
The simplest way to get started is to get an OpenAI API key (with payment method set up with OpenAI) and set it in the Copilot settings. Then simply pick gpt-4o
or gpt-4o-mini
in the model dropdown to start chatting. Make sure to set your default chat and embedding model in the first tab of Copilot settings.
For plus users, you can keep the embedding model as is copilot-plus-small
(it's a smaller but better model than the OpenAI large, and it's covered by your subscription). For free users, you can set the embedding model to text-embedding-3-small
as the starting point, and explore other embedding models once you get a sense of how this works.
Please check out the documentation for more details.
Try going through all the Copilot commands in the command palette, and see what they do. You can also checkout my youtube channel for previous demos.
Add model using the "Custom Model" form.
You can also use your own system prompt, choose between different embedding providers for Vault QA and more.
You can add, apply, edit and delete your own custom Copilot commands, all persisted in your local Obsidian environment!
Check out this demo video below!
This video shows how Advanced Custom Prompt works. This form of templating enables a lot more possibilities with long context window models. If you have your own creative cool use cases, don't hesitate to share them in the discussion or in the youtube comment section!
Now you can see the chat icon in your leftside ribbon, clicking on it will open the chat panel on the right! Don't forget to provide your API keys in settings before using the plugin!
main.js
, manifest.json
, styles.css
and put them under .obsidian/plugins/obsidian-copilot/
in your vaultCopilot
.You need to have access to the model APIs to use them. Usually they require an API key and a payment method.
A common misunderstanding I see is that some think they have access to GPT-4 API when they get ChatGPT Plus subscription. It's not always true (depending on when you signed up). You need to have access to GPT-4 API to use the model in this plugin. Please check if you have payment available on your OpenAI account. Then check OpenAI playground if you can use that particular model https://platform.openai.com/playground?mode=chat. Again, API access and ChatGPT Plus are two different things! You can use the API without the ChatGPT Plus subscription.
Reference issue: https://github.com/logancyang/obsidian-copilot/issues/3#issuecomment-1544583676
Please don't forget to switch to "Vault QA" in the Mode Selection dropdown in order to start the QA. Copilot does not have your note as context in "Chat" mode without an explicit [[notetitle]]
in the message.
Most likely because you haven't set up payment in your OpenAI account, or you exceeded your max monthly limit. OpenAI has a cap on how much you can use their API, usually $120 for individual users.
Reference issue: https://github.com/logancyang/obsidian-copilot/issues/11
Please refer to the model provider's documentation for the context window size. Note: if you set a big max token limit in your Copilot setting, you could get this error. Max token refers to completion tokens, not input tokens. So a bigger max output token limit means a smaller input token limit!
The prompts behind the scenes for Copilot commands can also take up tokens, so please limit your message length and max tokens to avoid this error. (For QA with Unlimited Context, use the "QA" mode in the dropdown! Requires Copilot v2.1.0.)
Reference issue: https://github.com/logancyang/obsidian-copilot/issues/1#issuecomment-1542934569
It's a bit tricky to get all Azure credentials right in the first try. My suggestion is to use curl
to test in your terminal first, make sure it gets response back, and then set the correct params in Copilot settings. Example:
curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/completions?api-version=VERSION\
-H "Content-Type: application/json" \
-H "api-key: YOUR_API_KEY" \
-d "{
\"prompt\": \"Once upon a time\",
\"max_tokens\": 5
}"
When opening an issue, please follow the issue template and include relevant console logs. You can go to Copilot's settings and turn on "Debug mode" at the bottom for more console messages. On Mac, you can open the console by pressing Cmd+Opt+I
. On Windows, you can open the console by pressing Ctrl+Shift+I
.
Copilot Plus is a premium product of Brevilabs LLC and it is not affiliated with Obsidian. It offers a powerful agentic AI integration into Obsidian. Please check out our website obsidiancopilot.com for more details!
If you share my vision, please consider sponsoring this project or buying me some coffees!
Please also help spread the word by sharing about the Copilot for Obsidian Plugin on Twitter/X, Reddit, or any other social media platform you use.
You can find me on Twitter/X @logancyang.