Mistral Cookbook

The Mistral Cookbook features examples contributed by Mistralers and our community, as well as our partners. If you have cool examples showcasing Mistral models, feel free to share them by submitting a PR to this repo.

Submission Guidelines:

• File Format: Please submit your example in the .md or .ipynb format.
• Runnable on Colab: If you're sharing a notebook example, try to make sure it's runnable on Google Colab.
• Authorship: Kindly include your name, your Github handle, and affiliation at the beginning of the file.
• Descriptions: Please include your notebook along with its category and descriptions in the table below.
• Tone: Kindly maintain a neutral tone and minimize any excessive marketing materials.
• Reproducibility: To ensure others can reproduce your work, kindly tag package versions in your code.
• Image size: If you have images, please make sure each image's size is below 500KB.
• Copyright: Always respect copyright and intellectual property laws.

Disclaimer: Examples contributed by the community and partners do not represent Mistral's views and opinions.

Content Guidelines:

• Originality: Is your content original and offering a fresh perspective?
• Clear: Is your content well-structured and clearly written?
• Value: Is your content valuable to the community? Does the community need it?

Local preview

This repository includes a lightweight Quarto preview site for reviewing Markdown and notebook cookbooks locally.

Install Quarto, generate the local preview files, then run the preview:

python3 scripts/generate_quarto_index.py
quarto preview --profile preview

Run the generator again after editing the cookbook tables in this README or Markdown cookbook files.

The preview renders committed notebook content without executing notebook code. Generated preview output is written to site/, and generated Markdown preview files are written as ignored sibling .qmd files next to their source Markdown files.

Main Notebooks

Notebook	Category	Description
quickstart.ipynb	chat, embeddings	Basic quickstart with chat and embeddings with Mistral AI API
prompting_capabilities.ipynb	prompting	Write prompts for classification, summarization, personalization, and evaluation
basic_RAG.ipynb	RAG	RAG from scratch with Mistral AI API
embeddings.ipynb	embeddings	Use Mistral embeddings API for classification and clustering
function_calling.ipynb	function calling	Use Mistral API for function calling
text_to_SQL.ipynb	function calling	Use Mistral API for function calling on a multi tables text to SQL usecase
evaluation.ipynb	evaluation	Evaluate models with Mistral API
mistral_finetune_api.ipynb	fine-tuning	Finetune a model with Mistral fine-tuning API
mistral-search-engine.ipynb	RAG, function calling	Search engine built with Mistral API, function calling and RAG
rag_via_function_calling.ipynb	RAG, function calling	Use function calling as a router for a RAG based on multiple data sources
prefix_use_cases.ipynb	prefix, prompting	Cool examples with Mistral's prefix feature
synthetic_data_gen_and_finetune.ipynb	data generation, fine-tuning	Simple data generation and fine-tuning guide
data_generation_refining_news.ipynb	data generation	Simple data generation to refine news articles
image_description_prompting_pixtral.ipynb	image processing, prompting	Extract structured image descriptions using Mistral's Pixtral model and JSON response formatting
multimodality meets function calling.ipynb	image processing, function calling	Extract table from image using Mistral's Pixtral model and use for function calling
mistral-reference-rag.ipynb	RAG, function calling, references	Reference RAG with Mistral API
moderation-explored.ipynb	moderation	Quick exploration on safeguarding and Mistral's moderation API
system-level-guardrails.ipynb	moderation	How to implement System Level Guardrails with Mistral API
document_understanding.ipynb	OCR, function calling	Document Understanding and Tool Usage with OCR
batch_ocr.ipynb	OCR, batch	Using OCR to extract text data from datasets.
structured_ocr.ipynb	OCR, structured outputs	Extracting structured outputs from documents.
RAG_evaluation.ipynb	evaluation, structured outputs, LLM As a Judge	Evaluate RAG with LLM as a Judge and structured outputs
product_classification.ipynb	fine-tuning, classifier	Fine-tuning a classifier for food classification.
intent_classification.ipynb	fine-tuning, classifier	Fine-tuning a classifier for intent classification.
moderation_classifier.ipynb	fine-tuning, classifier	Fine-tuning a classifier for moderation.
pixtral_finetune_on_satellite_data.ipynb	fine-tuning, image processing, batch	Fine-tuning a Pixtral-12B for satellite images classification.
sts_demo.py	chat, tts	STT -> LLM -> TTS Demo.
llm_judge_campaign_workflow.ipynb	observability, evaluation	Run campaigns with LLM judges to classify agent behaviors at scale
manage_datasets.ipynb	observability, datasets	Create and manage datasets for evaluation or fine-tuning

Third Party Tools

Tools	Category	Party
adaptive_rag_mistral.ipynb	RAG	Langchain
Adaptive_RAG.ipynb	RAG	LLamaIndex
Agents_Tools.ipynb	agent	LLamaIndex
arize_phoenix_tracing.ipynb	tracing data	Arize Phoenix
arize_phoenix_evaluate_rag.ipynb	evaluation	Arize Phoenix
azure_ai_search_rag.ipynb	RAG, embeddings	Azure
CAMEL Graph RAG with Mistral Models	multi-agent, tool, data gen	CAMEL-AI.org
CAMEL Role-Playing Scraper	multi-agent, tool, data gen	CAMEL-AI.org
Chainlit - Mistral reasoning.ipynb	UI chat, tool calling	Chainlit
chroma_mistral_embed_fn.ipynb	embeddings, vector DB	Chroma
adaptive_rag_mistral.ipynb	RAG	Langchain
distilabel_synthetic_dpo_dataset.ipynb	synthetic data	Argilla
E2B Code Interpreter SDK with Codestral	tool, agent	E2B
function_calling_local.ipynb	tool call	Ollama
Gradio Integration - Chat with PDF	UI chat, demo, RAG	Gradio
haystack_chat_with_docs.ipynb	RAG, embeddings	Haystack
Indexify Integration - PDF Entity Extraction	entity extraction, PDF	Indexify
Indexify Integration - PDF Summarization	summarization, PDF	Indexify
langgraph_code_assistant_mistral.ipynb	code	Langchain
langgraph_code_assistant_mistral.ipynb	code	Langchain
langtrace_mistral.ipynb	OTEL Observability	Langtrace
llamaindex_agentic_rag.ipynb	RAG, agent	LLamaIndex
llamaindex_arxiv_agentic_rag.ipynb	RAG, agent, Arxiv summarization	LLamaIndex
llamaindex_mistralai_finetuning.ipynb	fine-tuning	LLamaIndex
llamaindex_mistral_multi_modal.ipynb	MultiModalLLM-Pixtral	LLamaIndex
Maxim AI - Observability	Observability, Evaluation	Maxim AI
Microsoft Autogen - Function calling a pgsql db	Tool call, agent, RAG	Ms Autogen
Mesop Integration - Chat with PDF	UI chat, demo, RAG	Mesop
Monitoring Mistral AI using OpenTelemetry	AI Observability	OpenLIT
neon_text_to_sql.ipynb	code	Neon
ollama_mistral_llamaindex.ipynb	RAG	LLamaIndex
Ollama Meetup Demo	demo	Ollama
Open-source LLM engineering	LLM Observability	Langfuse
Panel Integration - Chat with PDF	UI chat, demo, RAG	Panel
phospho integration	Evaluation, Analytics	phospho
pinecone_rag.ipynb	RAG	Pinecone
RAG.ipynb	RAG	LLamaIndex
RouterQueryEngine.ipynb	agent	LLamaIndex
adaptive_rag_mistral.ipynb	RAG	Langchain
Solara Integration - Chat with PDFs	UI chat, demo, RAG	Solara
Streamlit Integration - Chat with PDF	UI chat, demo, RAG	Streamlit
Neo4j rag	RAG	Neo4j
SubQuestionQueryEngine.ipynb	agent	LLamaIndex
LLM Judge: Detecting hallucinations in language models	fine-tuning, evaluation	Weights & Biases
x mistral: CLI & TUI APP Module in X-CMD	CLI, TUI APP, Chat	x-cmd
Incremental Prompt Engineering and Model Comparison	Prompt Engineering, Evaluation	Pixeltable
Build a bank support agent with Pydantic AI and Mistral AI	Agent	Pydantic
Mistral and MLflow Tracing	Tracing, Observability	MLflow
Mistral OCR with Gradio	OCR	Gradio
prompt_optimization.ipynb)	Prompting	Optimizing prompts without any supervision