SmartRAG 3.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package SmartRAG --version 3.0.0
                    
NuGet\Install-Package SmartRAG -Version 3.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SmartRAG" Version="3.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SmartRAG" Version="3.0.0" />
                    
Directory.Packages.props
<PackageReference Include="SmartRAG" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SmartRAG --version 3.0.0
                    
#r "nuget: SmartRAG, 3.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SmartRAG@3.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SmartRAG&version=3.0.0
                    
Install as a Cake Addin
#tool nuget:?package=SmartRAG&version=3.0.0
                    
Install as a Cake Tool

πŸš€ SmartRAG

<p align="center"> <img src="icon.svg" alt="SmartRAG Logo" width="150"/> </p>

<p align="center"> <b>Multi-Database RAG Library for .NET</b><br> Ask questions about your data in natural language </p>

<p align="center"> <a href="https://www.nuget.org/packages/SmartRAG"><img src="https://img.shields.io/nuget/v/SmartRAG.svg?style=for-the-badge&logo=nuget" alt="NuGet Version"/></a> <a href="https://www.nuget.org/packages/SmartRAG"><img src="https://img.shields.io/nuget/dt/SmartRAG?style=for-the-badge&logo=nuget&label=Downloads&color=blue" alt="NuGet Downloads"/></a> <a href="https://github.com/byerlikaya/SmartRAG/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge" alt="License"/></a> </p>

✨ What SmartRAG Does

Transform your data into intelligent conversations. SmartRAG enables you to ask natural language questions across multiple databases, documents, images, and audio files - all through a single, unified API.

🎯 Key Capabilities

  • πŸ—„οΈ Multi-Database RAG - Query SQL Server, MySQL, PostgreSQL, SQLite together
  • πŸ“„ Multi-Modal Intelligence - PDF, Word, Excel, Images (OCR), Audio (Speech-to-Text)
  • πŸ”’ On-Premise Ready - 100% local with Ollama, LM Studio, Whisper.net
  • πŸ’¬ Conversation History - Built-in automatic context management
  • πŸ€– Universal AI Support - OpenAI, Anthropic, Gemini, Azure, Custom APIs
  • 🏒 Enterprise Storage - Qdrant, Redis, SQLite, FileSystem, In-Memory

πŸš€ Quick Start

dotnet add package SmartRAG
// Program.cs
builder.Services.UseSmartRAG(builder.Configuration,
    aiProvider: AIProvider.OpenAI,
    storageProvider: StorageProvider.InMemory
);

// Ask questions
var result = await _intelligence.QueryIntelligenceAsync("Your question here");

πŸ“š Documentation & Examples

🎯 Perfect For

  • Enterprise Applications - Multi-database intelligence systems
  • Document Management - PDF, Word, Excel processing with AI
  • Compliance Systems - GDPR/KVKK/HIPAA compliant deployments
  • Local AI Solutions - On-premise intelligence without cloud dependencies
  • Multi-Modal Applications - Text, images, audio, and database integration

πŸ†• What's New in v3.0.0

  • πŸ—„οΈ Multi-Database RAG - Query multiple databases with natural language
  • πŸ–ΌοΈ OCR Support - Image processing with Tesseract 5.2.0
  • 🎀 Audio Support - Local transcription with Whisper.net (99+ languages)
  • πŸ’¬ Conversation History - Built-in session management
  • πŸ”„ Enhanced API - Improved intelligence query interface

View full changelog β†’

πŸ“ž Support & Contact

πŸ“„ License

MIT License - see LICENSE for details.


Built with ❀️ by Barış Yerlikaya

Made in Turkey πŸ‡ΉπŸ‡· | Contact | LinkedIn

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.1.0 288 11/13/2025
3.0.3 337 11/6/2025
3.0.2 307 10/23/2025
3.0.1 373 10/22/2025
3.0.0 364 10/22/2025
2.3.1 226 10/8/2025
2.3.0 349 9/16/2025
2.2.0 383 9/15/2025
2.1.0 153 9/5/2025
2.0.0 314 8/27/2025
1.1.0 171 8/22/2025
1.0.3 186 8/20/2025
1.0.2 190 8/19/2025
1.0.1 158 8/17/2025
1.0.0 118 8/15/2025

Release 3.0.0: Intelligence Platform Revolution

BREAKING CHANGES - Major Platform Evolution:
β€’ Framework: Now requires .NET Standard 2.1 (.NET Core 3.0+) - Dropped .NET Framework support
β€’ SearchController β†’ IntelligenceController - Reflects true AI intelligence capabilities
β€’ GenerateRagAnswerAsync β†’ QueryIntelligenceAsync - Better represents intelligent query processing
β€’ API Endpoints: /api/search/* β†’ /api/intelligence/* - Professional enterprise naming
β€’ Enhanced API Documentation - Comprehensive Swagger documentation with examples
β€’ Complete Controller Suite - 8 comprehensive controllers with 65+ endpoints

Intelligence Platform Features:
β€’ Advanced Query Intelligence - Automatic intent detection and smart routing
β€’ Multi-Modal Search - Documents, databases, conversations, and hybrid search
β€’ Enterprise Analytics - Usage tracking, performance monitoring, and insights
β€’ Configuration Management - Runtime configuration updates and validation
β€’ Storage Management - Backup, restore, migration, and provider switching
β€’ Conversation Intelligence - Session management and context-aware responses

SQL Generation & Multi-Language Support:
β€’ Language-Safe SQL Generation - Automatic validation preventing non-English text in SQL queries
β€’ Multi-Language Query Support - AI handles queries in any language while generating pure English SQL
β€’ Character Validation - Detection of Turkish/German/Russian characters (ç, ğ, Δ±, ö, ş, ü, ä, ö, ü, ß, Cyrillic)
β€’ Keyword Validation - Prevention of non-English keywords in SQL (sorgu, abfrage, запрос)
β€’ PostgreSQL Full Support - Complete integration with live connections and schema analysis

On-Premise & Local AI Support:
β€’ Complete Local Operation - Ollama, LM Studio, and OpenAI-compatible local API support
β€’ Document Processing - PDF, Word, Excel parsing completely local
β€’ OCR Processing - Tesseract 5.2.0 completely local, no data sent to cloud
β€’ Database Integration - SQLite, SQL Server, MySQL, PostgreSQL all local connections
β€’ Storage Options - In-Memory, SQLite, FileSystem, Redis all local
β€’ Enterprise Compliance - GDPR/KVKK/HIPAA compliant, air-gapped systems support

Technical Improvements:
β€’ Professional API Design - RESTful endpoints with comprehensive documentation
β€’ Enterprise Architecture - SOLID principles, zero warnings policy maintained
β€’ Production Ready - Comprehensive error handling, validation, and logging
β€’ Swagger UI Optimization - Collapsed default view with enhanced navigation
β€’ Memory Management - Optimized performance with streaming and caching

Documentation and Developer Experience:
β€’ Multi-Language Documentation - Available in English, Turkish, German, and Russian
β€’ Complete API Documentation - All endpoints with detailed examples and use cases
β€’ Migration Guide - Step-by-step upgrade instructions from v2.4.0
β€’ Enhanced README - Updated with v3.0.0 features and breaking changes
β€’ Professional Swagger UI - Optimized interface with collapsed endpoints
β€’ Enterprise Examples - Real-world usage scenarios and best practices

Important Limitations:
β€’ Audio Files - Google Cloud Speech-to-Text API required (data sent to Google Cloud)
β€’ OCR Handwriting - Limited support for handwritten text (printed text works perfectly)

Migration from v2.4.0:
β€’ Update API endpoints: /api/search β†’ /api/intelligence
β€’ Update method calls: GenerateRagAnswerAsync β†’ QueryIntelligenceAsync
β€’ Update controller references: SearchController β†’ IntelligenceController
β€’ See migration guide in README.md for detailed instructions