VirtuosoFTS 1.0.10

Virtuoso.Search

A high-performance, embedded full-text search engine for .NET applications.

Features

• Blazing Fast: Optimized native core with BM25 ranking
• Near Real-Time (NRT): Immediate search availability after indexing
• Rich Query DSL: Fluent API for building complex queries
• Aggregations: Terms, Count, Min, Max, Stats, ScoreStats, Distinct
• Multiple Field Types: Text, Keyword, Numeric, DateTime, Boolean, JSON
• Thread-Safe: Safe for concurrent operations
• Dependency Injection: Built-in support for Microsoft.Extensions.DependencyInjection

Installation

dotnet add package Virtuoso.Search

Quick Start

1. Register Services

services.AddVirtuosoSearch(options =>
{
    options.IndexPath = "data/search-index";
    options.NrtReaderRefreshMs = 100;
});

2. Define Schema and Create Index

public class Product
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    public decimal Price { get; set; }
    public string Category { get; set; }
}

// Create index
var schema = new Dictionary<string, FieldDefinition>
{
    ["id"] = new("keyword", true),
    ["name"] = new("text", true),
    ["description"] = new("text", true),
    ["price"] = new("f64", true, false, true),
    ["category"] = new("keyword", true, true)
};

await searchService.CreateIndexAsync("products", schema);

3. Index Documents

var products = new[]
{
    new { id = "1", name = "iPhone 15", description = "Latest Apple smartphone", price = 999.99, category = "Electronics" },
    new { id = "2", name = "MacBook Pro", description = "Powerful laptop for professionals", price = 2499.99, category = "Electronics" }
};

await searchService.IndexDocumentsAsync("products", products);

4. Search

// Simple text search
var query = new QueryBuilder()
    .Match("name", "iPhone")
    .Build();

var results = await searchService.SearchAsync<Product>("products", query, limit: 10);

// Complex query with bool
var query = new QueryBuilder()
    .Bool(b => b
        .Must(q => q.Match("description", "laptop"))
        .Filter(q => q.Term("category", "Electronics"))
        .Filter(q => q.Range("price", gte: 1000, lte: 3000))
    )
    .Build();

Query Types

Aggregations

var aggs = new AggregationsBuilder()
    .Terms("categories", "category", 10)
    .Stats("price_stats", "price")
    .Build();

var results = await searchService.SearchAsync<Product>("products", query, aggregations: aggs);

foreach (var bucket in results.Aggregations["categories"].Buckets)
{
    Console.WriteLine($"{bucket.Key}: {bucket.Count}");
}

License

MIT License