diff --git a/README.md b/README.md index 58a8c4e..b70a8d7 100644 --- a/README.md +++ b/README.md @@ -230,6 +230,7 @@ Go to the [Usage](docs/USAGE.md) page to learn how to use all features. - **Multi-Notebook Support**: Organize your research across multiple notebooks effortlessly. - **Multi-model support**: Open AI, Anthropic, Gemini, Vertex AI, Open Router, X.AI, Groq, Ollama. ([Model Selection Guide](https://github.com/lfnovo/open-notebook/blob/main/docs/models.md)) +- **Reasoning Model Support**: Full support for thinking models like DeepSeek-R1, Qwen3, and Magistral with collapsible reasoning sections. - **Podcast Generator**: Automatically convert your notes into a podcast format. - **Broad Content Integration**: Works with links, PDFs, EPUB, Office, TXT, Markdown files, YouTube videos, Audio files, Video files and pasted text. - **Content Transformation**: Powerful customizable actions to summarize, extract insights, and more. diff --git a/docs/models.md b/docs/models.md index b31b7e6..41614f3 100644 --- a/docs/models.md +++ b/docs/models.md @@ -17,6 +17,7 @@ Open Notebook uses four types of AI models: **🎯 Quality**: Higher quality models often cost more but produce better results **⚡ Speed**: Smaller models are faster but may be less capable **🔧 Features**: Some models excel at specific tasks like tool calling or large contexts +**🧠 Reasoning**: Newer reasoning models can show their thought process for transparent decision-making --- @@ -68,19 +69,21 @@ Open Notebook uses four types of AI models: --- ### 🔵 DeepSeek -**Best for**: Cost-effective language models with good performance +**Best for**: Cost-effective language models with good performance and advanced reasoning **Language Models** - `deepseek-chat` - Excellent quality-to-price ratio with 64k context window +- `deepseek-reasoner` - Advanced reasoning model that shows its thinking process (available via Ollama) --- ### 🟡 Mistral -**Best for**: European-based alternative with competitive pricing +**Best for**: European-based alternative with competitive pricing and reasoning capabilities **Language Models** - `mistral-medium-latest` - Good balance of quality and price - `ministral-8b-latest` - Perfect for simple tasks like transformations +- `magistral` - Reasoning model with transparent thinking process **Embedding** - `mistral-embed` - Good quality, though not the most cost-effective @@ -116,17 +119,48 @@ Open Notebook uses four types of AI models: **Best for**: Privacy, offline use, and zero ongoing costs **Language Models** -- `qwen3` - Excellent free alternative for most language tasks +- `qwen3` - Excellent free alternative for most language tasks with reasoning capabilities - `gemma3` - Great for chat and simple transformations - `phi4` - Compact but capable model -- `deepseek-r1` - Advanced reasoning capabilities +- `deepseek-r1` - Advanced reasoning capabilities with transparent thinking - `llama4` - Well-rounded performance +- `magistral` - Light-weight reasoning model + **Embedding** - `mxbai-embed-large` - Outstanding free embedding model --- +## 🧠 Reasoning Models Support + +Open Notebook fully supports **reasoning models** that show their thought process. These models output their internal reasoning within `` tags, which Open Notebook automatically handles: + +### How It Works +- **In Chat**: Reasoning content appears in a collapsible "🤔 AI Reasoning" section +- **In Transformations**: Clean output is stored while reasoning is filtered out +- **In Search**: Final answers are clean and focused + +### Tested Models +We've tested extensively with these reasoning models: + +- **DeepSeek-R1** (via Ollama) - Exceptional reasoning quality, completely free +- **Qwen3** (via Ollama) - Good reasoning capabilities with fast performance +- **Magistral** (via Mistral) - European alternative with solid reasoning + +### Benefits +- **Transparency**: See exactly how the AI reached its conclusions +- **Trust**: Understand the reasoning behind responses +- **Learning**: Gain insights into AI problem-solving approaches +- **Clean Output**: Stored content remains focused and professional + +### Getting Started +1. Install any reasoning model (we recommend starting with `deepseek-r1` via Ollama) +2. Use it like any other model - the reasoning interface appears automatically +3. Click the "🤔 AI Reasoning" expander to explore the AI's thought process + +--- + ## Recommended Combinations ### 🌟 Best Value (Mixed Providers)