docs: update reasoning model instructions

This commit is contained in:
LUIS NOVO 2025-06-26 12:12:05 -03:00
parent 17b3ad010b
commit 9814103cc8
2 changed files with 39 additions and 4 deletions

View file

@ -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.

View file

@ -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 `<think>` 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)