Annoy (Approximate Nearest Neighbors Oh Yeah) è una libreria open source in C++ sviluppata da Spotify per eseguire ricerche approssimative dei vicini più prossimi (ANN) in spazi vettoriali ad alta dimensione. Ottimizzata per carichi di lavoro in lettura, Annoy è pensata per cercare rapidamente all’interno di grandi insiemi di vettori statici, ed è ampiamente usata in sistemi di raccomandazione, ricerca semantica, filtraggio basato sui contenuti e analisi di similarità musicale.

È particolarmente utile quando si gestiscono molti embeddings che cambiano raramente e devono essere interrogati con bassa latenza. Gli indici costruiti possono essere salvati su disco e mappati in memoria, rendendo l’utilizzo efficiente anche in ambienti di produzione.

Principali vantaggi:

• Prestazioni di lettura molto rapide con basso consumo di memoria

• Indici su disco condivisibili tra più processi

• Nessuna dipendenza esterna, facile da usare in C++ o Python

Quali sono le funzionalità principali di Annoy?

Ricerca approssimativa dei vicini più prossimi (ANN)

Annoy implementa algoritmi k-NN usando alberi di proiezione casuale per una ricerca veloce.

• Efficiente in spazi vettoriali ad alta dimensione

• Supporta query per i k vicini più simili

• Compatibile con metriche angolari (coseno), euclidee, Manhattan e Hamming

Indice su disco e memory mapping

Gli indici creati da Annoy sono di sola lettura e possono essere salvati su disco.

• Supporta il memory mapping per accesso rapido con poca RAM

• Più processi possono condividere lo stesso indice senza duplicazione

• Ideale per dataset statici ad alto volume di lettura

Libreria leggera e senza dipendenze

Annoy è scritta in C++ con binding Python e non richiede librerie esterne.

• Facile da compilare e integrare in altri progetti

• Interfaccia Python semplice, molto usata in progetti di machine learning

• Perfetta per ambienti con risorse limitate

Supporto per diverse metriche di distanza

Annoy offre funzioni di distanza multiple, utili per varie applicazioni.

• Distanza angolare (similarità coseno)

• Distanza euclidea (L2)

• Distanza Manhattan (L1)

• Distanza Hamming (per vettori binari)

Progettata per grandi dataset statici

Annoy è ottimizzata per casi d’uso con embeddings precomputati e stabili nel tempo.

• Gestisce milioni di vettori ad alta dimensione

• Il numero di alberi è configurabile per regolare il compromesso tra velocità e precisione

• Ottima per raccomandazioni, similarità visiva o acustica e ricerca vettoriale offline

Perché scegliere Annoy?

• Ideale per dati in sola lettura: ottimo per embeddings statici in produzione

• Efficiente su disco: indici rapidi da caricare e riutilizzabili

• Semplice e portabile: core C++ leggero con API Python facile da usare

• Supporto per più metriche: pronta all’uso senza dover scrivere funzioni personalizzate

• Affidabile in produzione: usato da Spotify in sistemi reali di raccomandazione e ricerca