Vane è un motore di ricerca AI open-source che emula l’esperienza di Perplexity, permettendo di effettuare ricerche sul web e ottenere risposte citate e verificate tramite modelli di linguaggio. Il progetto, precedentemente noto come Perplexica, è stato rinominato in Vane nel 2025 semplificando anche l’architettura: da tre container separati (backend, frontend e SearXNG) si è passati a un singolo container che include tutto il necessario per il funzionamento.
Vane supporta sia modelli locali tramite Ollama che provider cloud come OpenAI, Claude e Groq, lasciando all’utente la scelta del bilanciamento tra privacy e prestazioni. Il motore di ricerca web integrato è SearXNG , che aggrega i risultati da diversi motori senza tracciare le query.
Docker Compose
Dopo aver installato Docker Engine , è possibile procedere con l’installazione di Vane. La configurazione è particolarmente semplice grazie all’architettura a container singolo: tutto il necessario, incluso SearXNG, è già incluso nell’immagine Docker.
services:
vane:
image: itzcrazykns1337/vane:latest
container_name: Vane
ports:
- "3000:3000"
volumes:
- vane-data:/home/vane/data
- vane-uploads:/home/vane/uploads
restart: unless-stopped
volumes:
vane-data:
name: vane-data
vane-uploads:
name: vane-uploadsIl container espone la porta 3000 per l’interfaccia web e utilizza due volumi Docker: uno per la persistenza dei dati e della cronologia (vane-data) e uno per i documenti caricati dall’utente (vane-uploads) per l’analisi semantica. L’immagine latest include SearXNG integrato, quindi non è necessario configurare un’istanza esterna.
SearXNG esterno
Se si dispone già di un’istanza SearXNG in esecuzione, è possibile utilizzare l’immagine slim che non include il motore di ricerca integrato, riducendo il consumo di risorse. In questo caso è obbligatorio specificare l’URL dell’API di SearXNG:
services:
vane:
image: itzcrazykns1337/vane:slim-latest
container_name: Vane
ports:
- "3000:3000"
volumes:
- vane-data:/home/vane/data
- vane-uploads:/home/vane/uploads
environment:
- SEARXNG_API_URL=http://indirizzo-searxng:8080
restart: unless-stoppedAvvio e Configurazione
Una volta avviato il container con docker compose up -d, l’interfaccia di Vane sarà disponibile all’indirizzo http://<indirizzo_IP_server>:3000. Al primo accesso verrà mostrata una schermata di configurazione in cui è possibile impostare il provider AI da utilizzare e le relative chiavi API.
Connessione a Ollama
Per chi preferisce mantenere tutto in locale, Vane si integra con Ollama per l’utilizzo di modelli di linguaggio senza dipendere da servizi cloud. L’indirizzo da specificare nella configurazione di Vane dipende dal sistema operativo:
| Sistema | Indirizzo Ollama |
|---|---|
| Linux | http://<IP_privato_macchina>:11434 |
| Windows / macOS | http://host.docker.internal:11434 |
Su Linux è necessario indicare l’IP privato della macchina (ad esempio 192.168.1.100) invece di localhost o 127.0.0.1, poiché il container Docker opera in una rete isolata e non ha accesso diretto ai servizi in ascolto sull’interfaccia di loopback dell’host. Su Windows e macOS, Docker Desktop fornisce l’alias host.docker.internal che risolve automaticamente all’indirizzo dell’host.
Binding di Ollama
Ollama di default è in ascolto solo su127.0.0.1. Per renderlo raggiungibile dal container Docker su Linux è necessario configurarlo in modo che ascolti su tutte le interfacce (0.0.0.0). Questo si ottiene impostando la variabile d’ambiente OLLAMA_HOST=0.0.0.0 prima di avviare Ollama.
Provider Cloud
In alternativa a Ollama, Vane supporta anche provider AI cloud. Nella schermata di configurazione è possibile inserire direttamente le chiavi API di OpenAI, Anthropic (Claude), Google Gemini o Groq. Questa opzione è utile per chi vuole sfruttare modelli più potenti senza dover allocare risorse locali per l’inferenza.
Modalità di Ricerca
Vane offre tre modalità di ricerca che permettono di bilanciare velocità e qualità delle risposte:
| Modalità | Comportamento |
|---|---|
| Speed | Risposta rapida con ricerca web minimale |
| Balanced | Compromesso tra velocità e profondità di ricerca |
| Quality | Ricerca approfondita con più fonti e risposte più dettagliate |
Oltre alla ricerca generica, Vane include modalità specializzate per le discussioni su Reddit, la ricerca di paper accademici e il caricamento di documenti per l’analisi semantica.