explaingit

itzcrazykns/vane

34,459TypeScriptAudience · developerComplexity · 3/5MaintainedLicenseSetup · hard

TLDR

Self-hosted, privacy-focused AI search engine that answers questions using web results and local or cloud AI models, keeping all your searches on your machine.

Mindmap

mindmap
  root((Vane))
    What it does
      Web search and synthesis
      AI-powered answers
      Local search history
      Source citations
    Key features
      Image and video search
      File uploads
      Speed vs Quality modes
      Domain-specific search
    Tech stack
      TypeScript
      SearxNG
      Ollama support
      Docker deployment
    AI model options
      Local Ollama
      OpenAI
      Claude
      Gemini and Groq
    Use cases
      Research projects
      Technical lookups
      Privacy-conscious search
      Offline AI assistant
    Audience
      Researchers
      Developers
      Privacy advocates

Things people build with this

USE CASE 1

Run a private AI search assistant on your own server without sending queries to external companies.

USE CASE 2

Research technical topics with cited sources while keeping your search history completely offline.

USE CASE 3

Upload PDFs or images and ask questions about them using AI synthesis of web results.

USE CASE 4

Switch between fast answers and deeper research modes depending on your needs.

Tech stack

TypeScriptSearxNGOllamaDockerOpenAIClaudeGemini

Getting it running

Difficulty · hard Time to first run · 1day+

Requires Docker, SearxNG setup, Ollama or cloud API keys, and multiple service orchestration.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Vane is a privacy-focused, AI-powered search and answering engine you can run entirely on your own computer or server. Think of it as a self-hosted alternative to services like Perplexity, it takes your questions, searches the web, and returns a summarized answer with cited sources, all without sending your queries to any external company. The core idea is simple: when you type a question, Vane runs a web search in the background using SearxNG (a privacy-respecting meta-search engine that queries multiple search engines simultaneously without tracking you), collects the relevant results, and feeds them to an AI language model that synthesizes a coherent answer. Because the whole pipeline runs locally, your search history stays on your machine. Every search is also saved locally so you can revisit past research anytime. You can plug in the AI model of your choice. If you prefer to keep everything offline, it supports Ollama to run local models on your own hardware. If you are comfortable using cloud-based AI, it also connects to OpenAI, Anthropic Claude, Google Gemini, and Groq. You can even switch between a "Speed Mode" for quick answers and a "Quality Mode" for deeper research that takes a bit longer. Beyond plain text search, Vane supports image and video search, file uploads (so you can ask questions about a PDF or image you provide), domain-specific search (restricting results to certain websites), contextual widgets for things like weather or stock prices, and a browsable "Discover" section for trending content. You would reach for Vane if you want the convenience of an AI-powered search assistant but are uncomfortable with commercial services logging your queries. It is particularly useful for researchers, developers doing technical lookups, or anyone privacy-conscious who wants full control over their AI stack. The project is built with TypeScript and runs as a web app, deployable in minutes via Docker.

Copy-paste prompts

Prompt 1
How do I set up Vane with Ollama to run a completely offline AI search engine on my laptop?
Prompt 2
Show me how to deploy Vane using Docker and connect it to my OpenAI API key.
Prompt 3
Can I restrict Vane searches to specific domains like GitHub or Stack Overflow only?
Prompt 4
How do I upload a PDF to Vane and ask it questions about the content using web search context?
Prompt 5
What's the difference between Speed Mode and Quality Mode in Vane, and when should I use each?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.