Release notes from paperless-gpt

🛠️ v0.25.1 – Patch Release

2026-02-26T14:50:11Z

🛠️ v0.25.1 – Patch Release

Summary

This patch release fixes a regression introduced in v0.25.0 which caused the UI to enter a reload loop and fail to fetch documents from Paperless when the manual queue tag (e.g., with emoji or spaces, like 🤖 AI-Queue) was used.

What’s fixed

🟢 Unicode/emoji tag filtering now works: Fixes improper query encoding for tags with non-ASCII characters or spaces in tags__name__iexact. Paperless-ngx queries by emoji/spaced tags work as expected.
The UI no longer enters a reload loop when a tag like 🤖 AI-Queue is used as MANUAL_TAG.
No changes to other functionality or settings required.

How to upgrade

Update your paperless-gpt Docker image/tag to v0.25.1.
No migration steps or config changes are needed.

Thanks

Thank you to everyone reporting and helping debug this regression!

#898: “400 from paperless-gpt when querying documents by emoji tag via tags__name__iexact” – @icereed

What's Changed

Update README.md by @nettnikl in #895
Fix URL encoding for tag queries with special characters by @Copilot in #901

New Contributors

@nettnikl made their first contribution in #895

Full Changelog: v0.25.0...v0.25.1

v0.25.0 - "The Vision Expansion"

2026-02-16T08:31:48Z

🚀 paperless-gpt v0.25.0 - "The Vision Expansion"

Gemini joins the vision OCR party, polling gets smarter, and image processing becomes fully tunable!

🌟 Major New Features

👁️ Google Gemini as Vision (OCR) Provider

Google Gemini can now be used directly as a vision LLM provider for OCR! With native PDF handling, Gemini supports image, pdf, and whole_pdf processing modes out of the box—giving you even more flexibility for document processing.

Set VISION_LLM_PROVIDER: "googleai" and VISION_LLM_MODEL: "gemini-2.5-flash" to get started
Optional thinking budget support for reasoning models via GOOGLEAI_THINKING_BUDGET
Thanks to @its-a-unixsystem for this fantastic contribution!

🎛️ Configurable Image Processing Limits

Image processing limits are no longer hardcoded! You can now fine-tune max pixel dimensions, total pixels, render DPI, and max file size via environment variables. This is especially useful for smaller vision models like minicpm-v that perform better with appropriately sized images.

IMAGE_MAX_PIXEL_DIMENSION, IMAGE_MAX_TOTAL_PIXELS, IMAGE_MAX_RENDER_DPI, IMAGE_MAX_FILE_BYTES
Sensible defaults maintained for backward compatibility
Great addition by @cfilipov!

⚡ Performance Improvements

🔄 Smarter Paperless Polling

Polling for new documents is now significantly faster and lighter on resources. Instead of querying the full documents API, paperless-gpt now uses tag-based document counting to short-circuit when there's nothing to process—reducing response times from 500–1000ms down to 10–50ms on larger instances.

Fixes high CPU usage on paperless-ngx caused by aggressive polling
Single-tag retrieval replaces multi-tag queries
API calls are aborted early when no documents need processing
Thanks to @apoapoapo for this performance win!

🔧 CI/CD Improvements

🛡️ Secure Fork PR E2E Testing

Fork pull requests can now run E2E tests securely via a label-based approval workflow. Maintainers add the safe-to-test label after code review, which triggers E2E tests with secret access using local Docker builds—no registry credentials needed.
Contributed by @Copilot!

⚙️ Configuration Highlights

New Environment Variables

# Gemini Vision OCR
VISION_LLM_PROVIDER: "googleai"
VISION_LLM_MODEL: "gemini-2.5-flash"
GOOGLEAI_API_KEY: "your-api-key"
GOOGLEAI_THINKING_BUDGET: "16384"  # Optional
OCR_PROCESS_MODE: "whole_pdf"      # image, pdf, or whole_pdf

# Image Processing Limits
IMAGE_MAX_PIXEL_DIMENSION: "10000"
IMAGE_MAX_TOTAL_PIXELS: "40000000"
IMAGE_MAX_RENDER_DPI: "300"
IMAGE_MAX_FILE_BYTES: "10485760"

No Breaking Changes

Existing configurations continue to work as expected. All new features are opt-in!

📋 What's Changed

Add secure fork PR E2E testing with label-based approval by @Copilot in #857
Improve paperless polling for new documents by @apoapoapo in #889
feat: make image processing limits configurable by @cfilipov in #883
add Gemini as Vision (OCR) provider by @its-a-unixsystem in #881

🎉 New Contributors

A huge welcome to our new contributors! 🙌

@apoapoapo made their first contribution in #889
@cfilipov made their first contribution in #883
@its-a-unixsystem made their first contribution in #881

Full Changelog: v0.24.0...v0.25.0

Ready to upgrade?

docker pull icereed/paperless-gpt:latest

📚 Check out the README for full documentation on all features!

v0.24.0- "The Intelligence Expansion"

2026-01-14T21:28:09Z

🚀 paperless-gpt v0.24.0 - "The Intelligence Expansion"

Your AI-powered document processing just got smarter with Claude support, automatic document types, and a whole lot more!

🌟 Major New Features

🧠 Anthropic Claude API Support

Claude joins the party! You can now use Anthropic's powerful Claude models as your LLM provider. Perfect for users who prefer Claude's reasoning capabilities or want an alternative to OpenAI/Ollama.

Set LLM_PROVIDER: "anthropic" and configure your ANTHROPIC_API_KEY to get started
*Thanks to @kamcnally for this excellent addition! *

📁 Automatic Document Type Assignment

Paperless-gpt now intelligently suggests and assigns document types to your documents! Let the AI categorize your invoices, contracts, receipts, and more without lifting a finger.

UI toggle to enable/disable document type generation
View and edit suggested document types per document
Set AUTO_GENERATE_DOCUMENT_TYPE: "true" to get started
Brilliant contribution from @niklasfink!

🎨 Enhanced OCR UI & LLM Options

The OCR interface got a major facelift with more options for fine-tuning your LLM interactions—giving you greater control over how documents are processed.
Improved by @dawidkulpa!

🔧 Improvements & Fixes

🔗 Sub-Path Hosting Support

Hosting paperless-gpt behind a reverse proxy under a sub-path (e.g., /ai/) now works seamlessly! All frontend API calls are now sub-path aware, ensuring the Settings menu and other UI features load correctly.
*Thanks to @tldev-de! *

🐛 OCR Tag Loop Fix

Fixed a critical bug where the auto OCR tag would never be cleared when it was the last remaining tag, causing an endless processing loop.
*Fixed by @haigcd — closes #817! *

🏷️ Tag Removal Fix

Fixed handling of auto/manual tag removal to prevent sending empty arrays, which could cause issues with paperless-ngx.
Fixed by @itkevin — closes #659!

🤖 Reasoning Model Cleanup

OCR output now automatically strips <think> reasoning tags from models like DeepSeek-R1, giving you cleaner extracted text.
*Contributed by @Copilot! *

📄 Docling Provider Enhancements

Updated Docling server API to v1
Added support for PDF processing modes (pdf and whole_pdf)
New environment variables for additional configuration
Thanks to @T-Eberle and @Schweinhitti!

📦 What's Under the Hood

This release includes 100+ dependency updates across both Go backend and TypeScript frontend, keeping everything secure and up-to-date:

Component	Version
React	19.2.3
Go	1.25.5
Vite	7.3.0
Node.js	24
PostgreSQL	18
Alpine	3.23.0
Gin	1.11.0
GORM	1.31.1
LangChainGo	0.1.14
Google GenAI	1.39.0

CI/CD Improvements

Updated to actions/checkout v6, actions/setup-node v6, actions/setup-go v6
GitHub artifact actions updated to latest major versions
actions/cache updated to v5

📋 What's Changed

✨ Features

🔬 Ad-hoc Analysis to get answers from multiple documents by @icereed in #663
🤖 Add Anthropic/Claude API as LLM provider by @kamcnally in #795
📁 Document Type Assignment for Documents by @niklasfink in #848
🎨 Improves OCR UI and adds more options for LLMs by @dawidkulpa in #573

🐛 Bug Fixes

Fix frontend API/base paths when hosting under sub-path (e.g. /ai/) by @tldev-de in #844
Handle situation when auto OCR tag is the last remaining tag by @haigcd in #852
Handle removal of auto/manual tags without sending empty array by @itkevin in #738
Strip <think> reasoning tags from OCR output by @Copilot in #709

🔧 Improvements

Fixed Docling serve API version to v1 & added environment variables by @T-Eberle in #614
Update Docling provider to support PDF processing modes by @Schweinhitti in #758

🎉 New Contributors

A huge welcome to our new contributors! 🙌

@dawidkulpa made their first contribution in #573
@T-Eberle made their first contribution in #614
@Schweinhitti made their first contribution in #758
@itkevin made their first contribution in #738
@tldev-de made their first contribution in #844
@kamcnally made their first contribution in #795
@haigcd made their first contribution in #852
@niklasfink made their first contribution in #848

⚙️ Configuration Highlights

New Environment Variables

# Anthropic Claude Support
LLM_PROVIDER: "anthropic"
ANTHROPIC_API_KEY: "your-api-key"

# Document Type Generation
AUTO_GENERATE_DOCUMENT_TYPE: "true"

No Breaking Changes

Existing configurations continue to work as expected. All new features are opt-in!

Full Changelog: v0.23.0...v0.24.0

Ready to upgrade?

docker pull icereed/paperless-gpt:latest

📚 Check out the README for full documentation on all features!

"The Power User Edition"

2025-09-17T10:15:51Z

🚀 paperless-gpt v0.23.0 - "The Power User Edition"

Bringing AI-powered document processing to the next level with custom fields, external prompts, and enhanced developer experience!

🌟 Major New Features

📝 External Prompts & UI Editor

Transform how you customize AI behavior! You can now manage your prompts externally and edit them through a beautiful web interface. No more diving into config files - craft your perfect document processing prompts with ease.
Thanks to @hensing for this game-changing feature!

🎯 Automatic Custom Field Detection

paperless-gpt now intelligently detects and extracts custom fields from your documents automatically. Let AI discover the data patterns in your paperwork and suggest custom fields you never knew you needed.
Another brilliant contribution from @hensing!

⏱️ Document Processing Runtime Logging

Ever wondered how long each document takes to process? Now you'll know! Every document processing operation is timed and logged, giving you insights into performance and helping you optimize your AI workflows.
Big thanks to @matgoebl for this useful addition!

🛠️ Enhanced Developer Experience

We've added comprehensive GitHub Copilot instructions to make contributing to paperless-gpt a breeze. Whether you're fixing bugs or adding features, the development workflow is now smoother than ever.
Powered by @Copilot's first contribution to the project!

🔧 Infrastructure Improvements

Optional Docker Hub Pushes: More flexible CI/CD pipeline management
Date Validation: Better handling of invalid document dates
Dependency Fortress: Massive dependency update sweep keeping everything secure and up-to-date

📦 What's Under the Hood

This release includes 50+ dependency updates across both Go backend and TypeScript frontend, ensuring you're running on the latest and greatest packages. From React 19.1.1 to Go 1.25.0, we've got you covered.

🎉 New Contributors Welcome!

Special shoutout to @Copilot for joining our contributor family! 🤖

Ready to supercharge your document processing?

📥 Download: Release v0.23.0
📚 Documentation: Check out our updated docs for the new features
🐛 Issues: Found something? We love feedback!

Full Changelog: v0.22.0...v0.23.0

Support relative URLs for reverse-proxies

2025-07-17T08:50:21Z

Support relative URLs for reverse-proxies

Use relative URLs, so forwarding a sub-path from a reverse proxy works. Thanks to @matgoebl.

What's Changed

doc: clarify LLM_LANGUAGE by @thiswillbeyourgithub in #472
chore(deps): update dependency go to v1.24.4 by @renovate[bot] in #465
chore(deps): update dependency @types/react to v19.1.8 by @renovate[bot] in #462
fix(deps): update module google.golang.org/api to v0.239.0 by @renovate[bot] in #444
chore(deps): update dependency postcss to v8.5.6 by @renovate[bot] in #443
chore(deps): update docker.io/golang docker tag to v1.24.4 by @renovate[bot] in #481
fix(deps): update dependency react-router-dom to v7.6.3 by @renovate[bot] in #482
fix(deps): update module github.com/gen2brain/go-fitz to v1.24.15 by @renovate[bot] in #483
chore(deps): update dependency @types/node to v22.15.34 by @renovate[bot] in #430
chore(deps): update dependency typescript-eslint to v8.35.0 by @renovate[bot] in #431
chore(deps): update docker.io/alpine docker tag to v3.22.0 by @renovate[bot] in #447
fix(deps): update module github.com/hashicorp/go-retryablehttp to v0.7.8 by @renovate[bot] in #484
fix(deps): update module gorm.io/gorm to v1.30.0 by @renovate[bot] in #426
chore(deps): update dependency @playwright/test to v1.53.1 by @renovate[bot] in #485
chore(deps): update dependency dotenv to v16.6.1 by @renovate[bot] in #486
chore(config): migrate renovate config by @renovate[bot] in #487
fix(deps): update dependency axios to v1.10.0 by @renovate[bot] in #489
chore(deps): update eslint monorepo to v9.30.0 by @renovate[bot] in #488
chore(deps): update dependency dotenv to v17 by @renovate[bot] in #494
fix(deps): update module google.golang.org/genai to v1.13.0 by @renovate[bot] in #492
fix(deps): update dependency react-tooltip to v5.29.1 by @renovate[bot] in #490
chore(deps): update dependency vite to v7 by @renovate[bot] in #495
fix(deps): update module gorm.io/driver/sqlite to v1.6.0 by @renovate[bot] in #493
chore(deps): update dependency dotenv to v17.0.1 by @renovate[bot] in #499
chore(deps): update dependency @playwright/test to v1.53.2 by @renovate[bot] in #498
fix(deps): update module google.golang.org/api to v0.240.0 by @renovate[bot] in #491
chore(deps): update dependency typescript-eslint to v8.35.1 by @renovate[bot] in #500
chore(deps): update dependency vite to v7.0.2 by @renovate[bot] in #501
chore(deps): update dependency vite to v7.0.4 by @renovate[bot] in #504
chore(deps): update dependency go to v1.24.5 by @renovate[bot] in #503
chore(deps): update eslint monorepo to v9.30.1 by @renovate[bot] in #506
chore(deps): update docker.io/golang docker tag to v1.24.5 by @renovate[bot] in #505
chore(deps): update dependency @playwright/test to v1.54.1 by @renovate[bot] in #507
chore(deps): update dependency @types/node to v22.16.3 by @renovate[bot] in #508
chore(deps): update dependency dotenv to v17.2.0 by @renovate[bot] in #509
chore(deps): update dependency globals to v16.3.0 by @renovate[bot] in #510
chore(deps): update dependency typescript-eslint to v8.36.0 by @renovate[bot] in #511
chore(deps): update eslint monorepo to v9.31.0 by @renovate[bot] in #512
fix(deps): update module golang.org/x/sync to v0.16.0 by @renovate[bot] in #513
fix(deps): update module google.golang.org/api to v0.241.0 by @renovate[bot] in #514
fix(deps): update module google.golang.org/genai to v1.15.0 by @renovate[bot] in #515
chore(deps): update dependency @types/node to v22.16.4 by @renovate[bot] in #517
chore(deps): update docker.io/alpine docker tag to v3.22.1 by @renovate[bot] in #518
Use relative URLs, so forwarding a sub-path from a reverse proxy works. by @matgoebl in #516
chore(deps): update dependency typescript-eslint to v8.37.0 by @renovate[bot] in #519
fix(deps): update dependency react-router-dom to v7.7.0 by @renovate[bot] in #521
fix(deps): update module google.golang.org/api to v0.242.0 by @renovate[bot] in #522
chore(deps): update dependency vite to v7.0.5 by @renovate[bot] in #523
fix(deps): update module google.golang.org/genai to v1.16.0 by @renovate[bot] in #524

New Contributors

@matgoebl made their first contribution in #516

Full Changelog: v0.21.0...v0.22.0

v0.21.0

2025-06-19T14:24:07Z

Release Highlights 🚀

New Features

🔮 Mistral OCR Integration with Advanced PDF Processing

Extended PDF processing support - Mistral OCR now joins Google Document AI in supporting all processing modes: image, pdf, and whole_pdf
Cost-effective OCR - Purpose-built OCR endpoint optimized for document processing with competitive pricing
Markdown-formatted output - Returns well-structured markdown text that preserves document formatting and layout
Large document support - Handles files up to 50MB and 1,000 pages efficiently
Set OCR_PROVIDER: "mistral_ocr" and configure your Mistral API key to get started

🏷️ Enhanced Title Generation with Context

Original title context - Title generation now includes the existing document title as contextual information
Improved relevance - Language models can use the original title to generate more accurate and contextually appropriate suggestions
Better continuity - Maintains document naming consistency while enhancing title quality
Smart fallbacks - Handles cases where original titles are missing or incomplete

Improvements & Refinements

🛡️ Configuration Validation

OCR provider compatibility checks - Prevents invalid combinations of OCR providers and processing modes
Clear error messages - Detailed feedback when unsupported mode combinations are detected
Startup validation - Early detection of configuration issues before processing begins
Provider-specific guidance - Helpful error messages explain which modes are supported by each provider

📄 Enhanced PDF Processing Architecture

Hybrid file naming - Improved PDF splitting with standardized naming conventions that maintain backward compatibility
More provider choice - Users can now choose between Google Document AI and Mistral OCR for advanced PDF processing
Consistent behavior - Both advanced providers support pdf and whole_pdf modes with similar performance characteristics

🧪 Comprehensive E2E Testing

Mistral OCR test suite - Full end-to-end testing of Mistral OCR integration with real PDF documents
Processing mode validation - Tests verify whole_pdf mode works correctly with multi-page documents
Performance metrics - Test output includes detailed comparison of original vs. enhanced OCR content
Cross-provider compatibility - Tests ensure consistent behavior across different OCR providers

Documentation Updates

📚 OCR Provider Comparison

Updated provider documentation - Clear explanation of which providers support which processing modes
Mode compatibility matrix - Easy reference for choosing the right provider and mode combination
Mistral-specific guidance - Detailed setup instructions and best practices for Mistral OCR
Configuration examples - Complete docker-compose examples for all supported configurations

Technical Details

Provider Mode Support Matrix

Provider	image	pdf	whole_pdf
LLM (OpenAI/Ollama)	✅	❌	❌
Azure Document Intelligence	✅	❌	❌
Google Document AI	✅	✅	✅
Mistral OCR (New!)	✅	✅	✅
Docling	✅	❌	❌

What's Changed

feat: Add Mistral OCR provider with advanced PDF processing support - Extends pdf and whole_pdf mode support to a second provider
feat: Add OCR provider and processing mode validation - Prevents misconfigurations and provides helpful error messages
feat: Pass original document title to title generation prompt - Improves context and relevance of AI-generated titles #453
feat: Implement hybrid PDF naming strategy - Improved file naming with backward compatibility
test: Add comprehensive Mistral OCR E2E tests - Full test coverage including diff comparison utilities
docs: Update OCR processing modes documentation - Clear provider compatibility information

Configuration Example

environment:
  # Mistral OCR (new advanced PDF support)
  OCR_PROVIDER: "mistral_ocr"
  MISTRAL_API_KEY: "your_mistral_api_key"
  MISTRAL_MODEL: "mistral-ocr-latest"  # Optional
  OCR_PROCESS_MODE: "whole_pdf"        # Now supported!

Migration Notes

No breaking changes - Existing configurations continue to work as expected
More provider choice - Users now have two options for advanced PDF processing (pdf and whole_pdf modes)

Performance Benefits

Provider flexibility - Choose between Google Document AI and Mistral OCR based on your needs and pricing preferences
Reduced API calls - whole_pdf mode processes entire documents in one request (now available with both advanced providers)
Better accuracy - Direct PDF processing maintains document structure and formatting
Smarter title generation - Original title context leads to more relevant AI suggestions

PRs

fix(deps): update module github.com/pdfcpu/pdfcpu to v0.11.0 by @renovate in #434
fix: mislabeled data types in azure types by @moarsmokes in #455
chore(deps): update react monorepo to v19.1.7 by @renovate in #429
chore(deps): update dependency @vitejs/plugin-react-swc to v3.10.2 by @renovate in #424
Enhance title suggestions with original title by @icereed in #466
[mistral-ocr] Add MIME type detection, structured logging, and improv… by @icereed in #468

Full Changelog: v0.20.0...v0.21.0

v0.20.0

2025-05-30T14:39:51Z

Release Highlights 🚀

New Features

🧠 Google Gemini AI Integration

Added Google Gemini AI support - Paperless-GPT now supports Google's Gemini AI models as a new LLM provider option
Thinking budget support - Leverages Gemini's new thinking capabilities for enhanced document processing
Enhanced error handling - Improved API response validation and error management for Google AI services
Set LLM_PROVIDER: "googleai" and configure your Google AI API credentials to get started

Improvements & Refinements

🔧 LLM Prompt Optimization

Enhanced prompt structure - Added XML-like separators to LLM prompts for improved parsing accuracy and consistency
Better data organization - Input data is now enclosed in structured tags for clearer LLM interpretation
Improved reliability - More consistent results across different document types and LLM providers

📄 PDF Processing Fixes

Fixed split PDF logic - Updated file naming pattern to match pdfcpu output format (removes zero-padding)
Consistent naming - Split files now use simplified naming: original_1.pdf, original_2.pdf, etc.
Better workflow integration - Improved compatibility with existing PDF processing pipelines

Documentation Updates

📚 Model Recommendations

Updated model suggestions - Documentation now recommends qwen3:8b instead of deepseek-r1:8b for Ollama users
Better performance - qwen3:8b offers more recent and powerful reasoning capabilities
Improved examples - Updated configuration examples throughout the documentation

Dependencies & Maintenance

🔄 Dependency Updates

testcontainers updated to v10.28.0 - Latest testing framework improvements
globals updated to v16.2.0 - Enhanced JavaScript globals definitions
Automated maintenance - Renovate bot ensures dependencies stay current and secure

Technical Details

What's Changed

adds support for new gemini models with thinking budget #441
refactor: Add XML-like separators to LLM prompts for improved parsing #442
fix: the split pdf logic to be consistent with the output from pdfcpu #435
doc: mention qwen3:8b instead of deepseek-r1:8b #439
chore(deps): update dependency testcontainers to v10.28.0 #425
chore(deps): update dependency globals to v16.2.0 #428

Contributors

Special thanks to @thiswillbeyourgithub, @dawidkulpa, and @moarsmokes for their contributions to this release!

Configuration Notes

For Google Gemini AI: Set environment variables for GOOGLE_AI_API_KEY and configure LLM_PROVIDER: "googleai"
No breaking changes - existing configurations continue to work as expected
Consider updating to qwen3:8b model if using Ollama for better performance

New Contributors

@thiswillbeyourgithub made their first contribution in #439
@moarsmokes made their first contribution in #435

Full Changelog: v0.19.0...v0.20.0

Flexible OCR Processing Modes

2025-05-21T03:46:14Z

Release Highlights – v0.19.0

New: Flexible OCR Processing Modes

paperless-gpt now offers three distinct OCR processing modes, allowing you to optimize document processing based on your OCR provider and performance needs:

Image Mode (default)
Converts each PDF page into an image before OCR.
Best for: Maximum compatibility with all OCR providers.
Configure via: OCR_PROCESS_MODE: "image"
PDF Mode
Processes individual PDF pages directly, without image conversion.
Best for: Preserving PDF structure and improving speed or accuracy with native PDF-compatible providers.
Configure via: OCR_PROCESS_MODE: "pdf"
Whole PDF Mode
Sends the entire PDF as a single document for OCR.
Best for: Providers optimized for multi-page processing and reduced API calls.
Configure via: OCR_PROCESS_MODE: "whole_pdf"
Note: Large PDFs may exceed your provider's API limits—switch to pdf mode if issues occur.

Enhancements & Fixes

New Feature: Native PDF processing support for OCR #406
Fix: Azure OpenAI LLM integration #398
Dependency Updates:
- Core libraries: React, TypeScript, Node.js types, ESLint
- Backend: Gin, GORM, Google API modules, ocrchestra digest updates
- Build & test tools: Go 1.24.3, Docker images, Testcontainers

Full Changelog: v0.18.0...v0.19.0

"Workflow Greatness" - Automated Document Processing Pipeline 🔄

2025-05-05T15:34:40Z

"Workflow Greatness" - Automated Document Processing Pipeline 🔄

New Features 🚀

OCR Completion Tags
- Automatically tag documents after OCR processing is complete using PDF_OCR_COMPLETE_TAG
- Enable workflow automations based on OCR completion status
- Works seamlessly with all OCR providers

Quick Setup Guide 🛠️

environment:
  # For automatic OCR processing
  AUTO_OCR_TAG: "paperless-gpt-ocr-auto"  # Tag documents to trigger automatic OCR

  # Enable OCR completion tagging
  PDF_OCR_TAGGING: "true"
  PDF_OCR_COMPLETE_TAG: "paperless-gpt-ocr-complete"  # Tag added after OCR completion

How It Works 📋

Tag a document with paperless-gpt-ocr-auto to queue it for OCR processing
Document is processed using your configured OCR provider
Upon completion, the document is automatically tagged with paperless-gpt-ocr-complete
Use these tags to trigger further automations or workflows

Technical Improvements ⚙️

Enhanced test coverage for OCR workflow automation
Improved document processor architecture
Optimized test execution with parallel workers

What's Changed

Fix OCR completion tag and adds OCR document processing E2E test by @icereed in #379
fix(deps): update module gorm.io/gorm to v1.26.0 by @renovate in #377
chore(deps): update dependency vite to v6.3.5 by @renovate in #381
chore(deps): update dependency @types/react-dom to v19.1.3 by @renovate in #365
chore(deps): update dependency typescript-eslint to v8.31.1 by @renovate in #337
fix(deps): update module cloud.google.com/go/documentai to v1.37.0 by @renovate in #373
chore(deps): update eslint monorepo to v9.26.0 by @renovate in #332
chore(deps): update dependency eslint-plugin-react-refresh to v0.4.20 by @renovate in #349
fix(deps): update github.com/gardar/ocrchestra digest to 5fe7a0d by @renovate in #376
fix(deps): update module golang.org/x/sync to v0.14.0 by @renovate in #382

Full Changelog: v0.17.0...v0.17.1

"Mistral Magic" - Smarter OCR, Sharper PDFs 🌟

2025-05-05T08:27:55Z

Major Features

🤖 Mistral AI Integration

Added Mistral AI as a new provider for both OCR and LLM capabilities
Integrated Vision models for adaptable document processing
Added dedicated OCR service optimized for document processing
Included configuration options for OCR methods
Enhanced rate limiting with retry mechanisms for stable API interaction

📄 PDF Processing Improvements

Implemented intelligent PDF page extraction with size optimization
Added smart dimension limits (10K pixels max per side, 40MP total)
Introduced adaptive JPEG quality adjustment (85-60 range)
Added intelligent resizing based on target file size
Fixed issues with oversized PDF page extractions

Technical Improvements

⚡ Performance

Implemented rate limiting and retry controls for LLM requests
Added configurable rate limits via environment variables
Optimized image processing for better resource utilization

🧪 Testing & Documentation

Added comprehensive tests for Mistral OCR provider
Added tests for rate-limited LLM client behavior
Expanded test coverage for image processing and error scenarios
Added documentation for Mistral integration and configuration

PRs

fix: oversized PDF page extractions by @gardar in #362
fix(deps): update module github.com/gabriel-vasile/mimetype to v1.4.9 by @renovate in #351
chore(deps): update dependency dotenv to v16.5.0 by @renovate in #343
fix(deps): update dependency @headlessui/react to v2.2.2 by @renovate in #350
chore(deps): update dependency @types/node to v22.15.3 by @renovate in #342
fix(deps): update github.com/gardar/ocrchestra digest to 2d28866 by @renovate in #364
chore(deps): update dependency testcontainers to v10.25.0 by @renovate in #369
chore(deps): update dependency @playwright/test to v1.52.0 by @renovate in #367
chore(deps): update dependency @vitejs/plugin-react-swc to v3.9.0 by @renovate in #368
fix(deps): update dependency axios to v1.9.0 by @renovate in #372
Adds Mistral AI integration for OCR and LLM by @icereed in #366
chore(deps): update dependency vite to v6.3.4 by @renovate in #371
fix(deps): update module google.golang.org/api to v0.231.0 by @renovate in #374
fix(deps): update dependency react-router-dom to v7.5.3 by @renovate in #334
fix(deps): update dependency react-tooltip to v5.28.1 by @renovate in #338

Full Changelog: v0.16.0...v0.17.0