Plugin icon

NoteLLM

by HorseSword
productivity
Install Plugin
Your very own AI-powered note plugin.

Description

Your very own AI-powered note plugin. It's completely open-source and does not collect any logs or personal information.

Additional Information

Links:
Maintainers: horsesword
Version:0.4.14
Minimum app version:3.2
Downloads: This version:0
Last updated:N/A

Joplin Plugin: NoteLLM

Your very own AI-powered note plugin for Joplin. It's completely open-source and does not collect any logs or personal information.

notellm

Features

  • Customizable LLM Service Source:
    • Configure the source of your Large Language Model (LLM) service, including options like openai, deepseek, qwen, or even a local LLM server that is compatible with openai-api, for example ollama. Configuration requires specifying a URL, API key, and model name.
    • You can find examples in 'Usage Instructions' part below.
  • Chat:
    • If no selection: Chat with LLM on texts all above cursor. All texts after cursor will not be sent to LLM.
    • If any texts are selected: only selected texts will be sent.
    • New feature: "Advanced Chat Mode". Split texts into pieces like {"role":"user","content":"xxx"}.
  • Summarization:
    • If no selection: Summarize all above cursor.
    • If any texts are selected: Summarize selected text portions efficiently.
  • Improve your selection:
    • Improve the expression of selected text. This will consider context before and after selection.
    • You can tell LLM how to improve it.
  • Question & Answer:
    • Ask LLM about selected texts.

Mobile Support

Currently, mobile users can enjoy the chat functionality over the entire note text.

Others functions are under development.

Known problems on mobile app:

  • On mobile app, some LLM servers may not function properly due to CORS restrictions. It is known that ollama has this issue; you can try configuring a proxy to resolve it. This is restricted by framework and I can not fix it now.
  • Sometimes, when you click on a plugin icon, there is no response. Killing the app's background process and restarting the app usually resolves this issue. The cause may be related to Joplin's background management, though I am unable to pinpoint the exact problem at this time.

Usage Instructions

This plugin can only work in markdown editor!!!!

This plugin can only work in markdown editor!!!!

This plugin can only work in markdown editor!!!!

After installing this plugin, you should go to settings to configure your ai options. At least input one URL, API key, and model name.

You can configure up to 3 LLMs and switch among them.

Some examples for settings

Currently, this plugin support OpenAI-API (including OpenAI compatibility APIs). Thanks to Ian Channing.

Examples LLM server url LLM model name (examples)
OpenAI https://api.openai.com/v1 o3
Claude https://api.anthropic.com/v1 claude-3-7-sonnet-20250219
Deepseek https://api.deepseek.com/v1 deepseek-chat, or deepseek-reasoner
Qwen https://dashscope.aliyuncs.com/compatible-mode/v1 qwen-plus
Google Gemini https://generativelanguage.googleapis.com/v1beta gemini-2.0-flash
volcengine https://ark.cn-beijing.volces.com/api/v3 doubao-1.5-pro-32k
ollama (local) http://your_id:your_port/v1 (YOUR_MODEL_NAME)

Reminder: I tested qwen, deepseek, volcengine and ollama. If you find error(s), please tell me. Thank you.

image-20250211191521564

Then you will have access to several features. First, a chat icon appears at the top of the markdown editing interface. Clicking on it triggers a conversation with AI based on all preceding content up to your cursor position.

image-20250211190649811

And, in the top menu under Tools / NoteLLM, find quick access to all functions. Some have shortcut keys for easy invocation.

image-20250211190753843

Update Logs

  • v0.4.14, 2025-06-14. We can set our own prompt for chatting now.
  • v0.4.13, 2025-05-25. (1) Added animation for waiting. (2) Bug fixed: Stop running if note changed unexpectedly.
  • v0.4.12, 2025-05-17. (1) We can hide contexts between <think> and </think> now. (2) Maintaining the cursor's position during generation, in order to avoid text input position errors caused by cursor movement.
  • v0.4.11, 2025-05-04. New promo_tile.
  • v0.4.10, 2025-05-04. New advanced chat mode. Optimize the parsing of previous text based on chat characteristics, including splitting dialogue roles, skipping the 'think' part of the reasoning model, and other functions.
  • v0.4.9, 2025-04-15. Improved prompts for "chat" and "summary". Thanks to Adam Outler. And, useless old files removed.
  • v0.4.8, 2025-04-03. Improved the prompts to fix a bug that caused responses to non-Chinese content to be in Chinese.
  • v0.4.7, 2025-03-30. Tried to fix CORS of Claude API.
  • v0.4.6, 2025-03-09. We can set up to 3 LLMs now.
  • v0.4.5, 2025-03-09. Bug fixed.
  • v0.4.4, 2025-03-08. Add dialogs for "LLM ask" and "LLM improve".
  • v0.4.3, 2025-03-07. Multi-language (Simplified Chinese) supported.
  • v0.4.2, 2025-03-06. LLMs can be switched via tool menu.
  • v0.4.0, 2025-02-25. Better support for mobile app.

Thank you!

NoteLLM is designed to enhance your note-taking experience with powerful AI capabilities while ensuring privacy and customization.