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.

yaml
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-uploads

Il 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:

yaml
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-stopped

Avvio 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 su 127.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.