Smart Composer

Documentation · Report Bug · Discussions

Everytime we ask ChatGPT, we need to put so much context information for each query. Why spend time putting background infos that are already in your vault?

Smart Composer is an Obsidian plugin that helps you write efficiently with AI by easily referencing your vault content. Inspired by Cursor AI and ChatGPT Canvas, this plugin unifies your note-taking and content creation process within Obsidian.

Features

Contextual Chat

Upgrade your note-taking experience with our Contextual AI Assistant, inspired by Cursor AI. Unlike typical AI plugins, our assistant allows you to precisely select the context for your conversation.

• Type @<fname> to choose specific files/folders as your conversation context
• Get responses based on selected vault content

Multimedia Context

Now, you can add website links and images as additional context for your queries.

• Website content is automatically extracted
• Image support: Add images directly to your chat through:
  • Upload button
  • Drag & drop
  • Paste from clipboard
• Youtube link support: YouTube transcripts are fetched and included as context
• Coming soon: Support for external files (PDF, DOCX, …)

Apply Edit

Smart Composer suggests edits to your document. You can apply with a single click.

• Offers document change recommendations
• Apply suggested changes instantly

Vault Search (RAG)

Automatically find and use relevant notes from your vault to enhance AI responses.

• Hit Cmd+Shift+Enter to run Vault Search answer
• Semantic search across your vault to find the most relevant context

Additional Features

• Custom Model Selection: Use your own model by setting your API Key (stored locally). Supported providers:
  • OpenAI
  • Anthropic
  • Google (Gemini)
  • Groq
  • DeepSeek
  • OpenRouter
  • Azure OpenAI
  • Ollama
  • LM Studio
  • MorphLLM
  • Any other OpenAI-compatible providers
• Local Model Support: Run open-source LLMs and embedding models locally with Ollama for complete privacy and offline usage.
• Custom System Prompts: Define your own system prompts that will be applied to every chat conversation.
• Prompt Templates: Create and reuse templates for common queries by typing / in the chat view. Perfect for standardizing repetitive tasks.
  • Create templates from any selected text with one click

Getting Started

⚠️ Important: Installer Version Requirement
Smart Composer requires a recent version of the Obsidian installer. If you experience issues with the plugin not loading properly:

1. First, try updating Obsidian normally at Settings > General > Check for updates.

2. If issues persist, manually update your Obsidian installer:

   • Download the latest installer from Obsidian's download page
   • Close Obsidian completely
   • Run the new installer

1. Open Obsidian Settings
2. Navigate to "Community plugins" and click "Browse"
3. Search for "Smart Composer" and click Install
4. Enable the plugin in Community plugins
5. Set up your API key in plugin settings
   • OpenAI : ChatGPT API Keys
   • Anthropic : Claude API Keys
   • Gemini : Gemini API Keys
   • Groq : Groq API Keys

💡 Free Option Available: While rate-limited, Gemini API provides the best performance among free models for Smart Composer. Recommended for users looking for a free option.

📚 For detailed setup instructions and documentation, please visit our Documentation.

Roadmap

To see our up-to-date project roadmap and progress, please check out our GitHub Projects kanban board.

Some of our planned features include:

• Support for external files (PDF, DOCX, etc.)
• Mentioning with tags or other metadata

Feedback and Support

We value your input and want to ensure you can easily share your thoughts and report any issues:

• Bug Reports: If you encounter any bugs or unexpected behavior, please submit an issue on our GitHub Issues page. Be sure to include as much detail as possible to help us reproduce and address the problem.

• Feature Requests: For new feature ideas or enhancements, please use our GitHub Discussions - Ideas & Feature Requests page. Create a new discussion to share your suggestions. This allows for community engagement and helps us prioritize future developments.

• Show and Tell: We love seeing how you use Smart Composer! Share your unique use cases, workflows, or interesting applications of the plugin in the GitHub Discussions - Smart Composer Showcase page.

Your feedback and experiences are crucial in making Smart Composer better for everyone!

Contributing

We welcome all kinds of contributions to Smart Composer, including bug reports, bug fixes, documentation improvements, and feature enhancements.

For major feature ideas, please create an issue first to discuss feasibility and implementation approach.

If you're interested in contributing, please refer to our CONTRIBUTING.md file for detailed information on:

• Setting up the development environment
• Our development workflow
• Working with the database schema
• The process for submitting pull requests
• Known issues and solutions for developers

Contributors

Core Team

These contributors were instrumental in shaping the initial vision, architecture, and design of Smart Composer:

@glowingjade (Twitter), @kevin-on, @realsnoopso (Twitter · LinkedIn), @woosukji

Additional Contributors

We also want to thank everyone else who has contributed. Your time and effort help make Smart Composer better for everyone!

License

This project is licensed under the MIT License.

Support the Project

If you find Smart Composer valuable, consider supporting its development:

Follow me on X (Twitter) @andy_suh_ for updates and announcements!

Your support helps maintain and improve this plugin. Every contribution is appreciated and makes a difference. Thank you for your support!

Star History