Define a search endpoint using dependency-injected Autypo:

app.MapGet("/products/search", async (
    [FromQuery] string query,
    [FromServices] IAutypoSearch<Product> search) =>
{
    var results = await search.SearchAsync(query);
    return results.Select(r => r.Value);
});

Example Query:

GET /products/search?query=fngerprint usb recogn

Example Result:

[
 {
   "code": "A1067",
   "name": "Fingerprint USB",
   "description": "Secure USB flash drive with fingerprint encryption"
 },
]

📦 Installation

Autypo is available on NuGet.

For ASP.NET Core integration (includes the core engine):

dotnet add package Autypo.AspNetCore

For standalone or non-web scenarios (e.g., console apps, background jobs):

dotnet add package Autypo

💡 Features

Autypo gives you fast, typo-tolerant search with modern developer ergonomics — zero config to start, but extreme tuning if you need it.

🧠 Intelligent Matching

• Typo-tolerant by default — fuzzy, partial, and out-of-order input
• Token-level matching control (prefix, fuzziness)
• Opt-in partial matching and out-of-order input
• Built to rank “real world” input
• Multi-index support with priority-based short-circuiting

🔧 Deeply Configurable

• Index multiple fields (e.g. name + description)
• Plug in custom scorers, filters, and match policies
• Add tokenizers and analyzers (N-grams, stemming, etc)
• Per-query tuning for fuzziness, partial match, max results

⚙️ Production-Ready

• Blazing-fast in-memory autocomplete via IAutypoComplete
• Full-featured, multi-index search engine via IAutypoSearch<T>
• Eager, background, or lazy indexing — your choice
• Refresh indexes at runtime with AutypoRefreshToken
• Async-first, thread-safe, allocation-conscious

🌐 Framework-Friendly

• ASP.NET Core integration with full DI support
• Blazor Server–ready (ideal for typeahead inputs)
• Fully .NET-native — no native bindings, no hosted servers

✅ Open source & MIT licensed
🛡️ Built for scale and safety
🎉 Developer-first design

⚠️ Limitations

Autypo is intentionally designed for short-text and autocomplete scenarios — not full-text search.

• Documents are limited to 64 tokens max (e.g., product names, commands, short descriptions)
• In-memory indexing is fast and efficient, but may not suit massive corpora or multi-megabyte documents
• Autypo is not intended for long-form text search — for that, consider Lucene or ElasticSearch

This tradeoff is deliberate: it keeps Autypo incredibly fast, predictable, and ideal for UX-critical search.

🎯 Perfect For

• E-commerce product & SKU search
• Admin panel filtering and form helpers
• Smart command palettes
• CLI "Did You Mean?" suggestions
• Blazor autocomplete inputs
• Live-search over reference data (countries, tags, part numbers)
• Fuzzy full-text matching over short documents

📚 Learning Resources

📖 Guides

💻 Samples

📊 Benchmarks

Autypo competes head-to-head with Lucene and outperforms many .NET libraries for short-string search:

* Levenshtypo is the fuzzy string search library that powers Autypo’s low-level approximate matching engine. It supports typo-tolerant single-token search using optimized Tries and Levenshtein Automata.

⚠️ See full benchmark repo and disclaimer →

📁 Project Structure

/src
  └── Autypo/                   # Core library
  └── Autypo.AspNetCore/        # ASP.NET Core integration
  └── Autypo.Benchmarks/        # Microbenchmarks
  └── Autypo.IntegrationTests/
  └── Autypo.UnitTests/
  └── Autypo.Aot/               # Ensures that Autypo works in AOT scenarios
  
/samples
  └── ApiSearchProducts/        # REST API example
  └── BlazorCities/             # Blazor Server autocomplete
  └── ConsoleDidYouMean/        # CLI demo

💬 Support and Feedback

🧠 Have a question?
💡 Got feedback?
🐛 Found a bug?

Open an issue or start a discussion. We'd love to hear from you.

⚖️ License

Autypo is released under the MIT License.

🙋‍♂️ What's in a Name?

Autocomplete + Typo-tolerance = Autypo.

Simple name, serious power.

Built for modern .NET developers.