LibreAI / RAG & Knowledge / swirl-search
// rag · swirlai/swirl-search

swirl-search

Federated AI search and RAG across 100+ apps — answers with sources, without moving your data

★ 3.0k stars⑂ 288 forksApache-2.0updated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

swirl-search is an open-source rag & knowledge project by swirlai (swirlai/swirl-search on GitHub). It has 3,047 GitHub stars and 288 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 26 September 2026.

GitHub stars
3,047
Forks
288
License
Apache-2.0
Last updated on GitHub
26 September 2026
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    List the sources you want to search in one place — the README notes connectors across 100+ apps, and it searches Arxiv, European PMC and Google News out of the box.

  2. Get SWIRL

    Download the project's docker-compose.yaml (or clone the repo) with Docker installed and running.

  3. Install and configure

    Optionally set your own OpenAI key and host variables for real-time RAG, then pull and start the containers.

  4. Run your first search

    Open the Galaxy UI, log in, and run a question across your connected sources to see ranked, cited answers.

// features

Why people love it

Federated live search

Queries run live against your sources in place, with the user's own permissions enforced at the source.

RAG with citations

Optionally generates an answer using the LLM of your choice, with sources you can click through to verify.

No vector database

No vector DB, ETL pipeline or duplicated copy of your data to secure and audit.

100+ connectors

Connects across a large library of enterprise and public sources (see the project's connector list).

Fast Docker start

Starts with one Docker Compose flow and is usable in about two minutes per the README.

Open Community edition

The open-source Community edition is Apache-2.0; a separate Enterprise edition adds features such as a three-pass reranker and an MCP server.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone SWIRL Search and enter the directory (alternatively just download its docker-compose.yaml).

    git clone https://github.com/swirlai/swirl-search.git
    cd swirl-search
  2. Download the compose file

    As the README quick start shows, you can fetch the compose file directly.

    curl https://raw.githubusercontent.com/swirlai/swirl-search/main/docker-compose.yaml -o docker-compose.yaml
  3. Start SWIRL

    Pull and start the containers, then open http://localhost:8000/galaxy and log in with admin / password.

    docker-compose pull && docker-compose up
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains SWIRL?

It is developed by swirlai (SWIRL AI) as the open-source SWIRL Community edition, alongside a commercial Enterprise edition.

Is SWIRL free?

The Community edition in this repo is free and Apache-2.0 licensed. Enterprise features and managed support are a separate commercial offering.

Does it need a paid API key?

Federated search works without one; real-time RAG with OpenAI requires your own OpenAI API key, set via the OPENAI_API_KEY environment variable.

How does it compare to a vector-database RAG stack?

Typical stacks copy and embed all your data first. SWIRL queries sources live, in place, so there is no duplicate corpus to govern.

How do I get started?

Install Docker, download docker-compose.yaml, run docker-compose pull && docker-compose up, then open http://localhost:8000/galaxy.

// keep exploring

Similar tools

RAG & Knowledge

OpenDocuments

Self-hosted RAG search across GitHub, Drive, Notion, and local files.

★ 115 starsMIT
View guide →
RAG & Knowledge

ezdata

AI-native data platform: 60+ connectors, ETL, scheduling, and RAG search.

★ 293 starsMIT
View guide →
RAG & Knowledge

llm-app

Ready-to-run templates for RAG, AI pipelines and enterprise search that stay in sync with live data

★ 58.8k starsMIT
View guide →
RAG & Knowledge

SQLBot

SQLBot — DataEase's conversational analytics: ask in natural language, get SQL answers via LLMs plus RAG.

★ 6.9k starsGPL-3.0
View guide →
RAG & Knowledge

AutoRAG

An agent that finds anything on your computer — federated search over your files, in place.

★ 5.1k starsMIT
View guide →
RAG & Knowledge

coco-server

Free rag & knowledge tool that 🥥 coco ai server - search, connect, collaborate, ai-pow.

★ 147 starsNOASSERTION
View guide →
// alternatives

Alternatives in RAG & Knowledge

The most-starred other RAG & Knowledge projects in the LibreAI catalogue — the realistic shortlist if swirl-search is not the right fit.

Get swirl-search

Free and open — grab the source, star the repo, and start creating.