Skip to content
Projects

dukesky/PolarBear has 201 GitHub stars and 33 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 11:04 UTC. Last push 2026-08-22.

How these counts are measured

What you can do

  • πŸ” Hybrid Search: seamlessly blends keyword matching (BM25) with AI-powered semantic search (Embeddings) for superior result relevance.
  • ⚑ No-Code Ingestion: Upload your data via CSV, Excel, or Google Sheets. No coding required.
  • 🧠 AI-Ready: Built-in vectorization pipeline using state-of-the-art embedding models.
  • πŸ“Š Insights Dashboard: Track user behavior, top queries, zero-result searches, and conversion metrics.

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Fully Open Source Search Engine for SME (Small Medium Size Enterprise)

Developer Tools

README.md

Original
PolarBear Logo

PolarBear πŸ»β€β„οΈ

The Open-Source Hybrid Search Engine for SMEs

License: MIT Python Next.js Docker

Features β€’ Getting Started β€’ Documentation β€’ Contributing


🌟 Introduction

PolarBear is a powerful, no-code, AI-enhanced search engine designed specifically for Small and Medium-sized Enterprises (SMEs). It democratizes access to advanced search technology, allowing business owners to create a professional search experience for their products, services, or inventory in minutesβ€”completely free and open source.

Unlike complex enterprise solutions, PolarBear focuses on simplicity without compromising on power. It combines Keyword Search (Meilisearch) and Semantic Vector Search (FAISS) to deliver results that are both accurate and contextually relevant.

PolarBear is open-core: this repository is the complete product under the MIT license β€” clone it, self-host it, study it, extend it. The same codebase can also run as a hosted multi-tenant service where store owners simply register, upload their catalog, and paste two lines of code into their website.

πŸ›οΈ Add Search to Your Store β€” in 3 Steps

Store owner with no technical background? This is for you.

  1. Upload your products β€” a CSV with your product names, descriptions, and prices.
  2. Copy your embed code β€” the Settings page generates it, with platform-specific guides for Shopify, WordPress, and Wix.
  3. Paste it into your site β€” into your site builder's "custom code" box. Done.
<div id="polarbear-search"></div>
<script src="https://your-polarbear-server/widget.js" data-key="pb_search_..." async></script>

Your shoppers get a search-as-you-type overlay with AI semantic matching ("cozy gift" finds your scented candles); you get a dashboard of what they searched and clicked.

πŸ“– Full integration guide β†’ docs/INTEGRATION.md β€” step-by-step per platform, CSV format, widget options, API reference, self-hosting, and troubleshooting.

See it working in 2 minutes

The repo ships a demo storefront β€” a small hardware store with 18 products β€” so you can experience both sides without writing anything:

cd demo-store && python3 -m http.server 4173

Upload demo-store/products.csv to your PolarBear account, paste your search key into the page, then search β€œmy faucet drips”. You get the faucet washer assortment β€” a product whose title shares no word with your query. That's the difference between keyword search and PolarBear.

πŸ“¦ Demo storefront β†’ demo-store/

πŸš€ Features

  • πŸ” Hybrid Search: seamlessly blends keyword matching (BM25) with AI-powered semantic search (Embeddings) for superior result relevance.
  • ⚑ No-Code Ingestion: Upload your data via CSV, Excel, or Google Sheets. No coding required.
  • 🧠 AI-Ready: Built-in vectorization pipeline using state-of-the-art embedding models.
  • πŸ“Š Insights Dashboard: Track user behavior, top queries, zero-result searches, and conversion metrics.
  • πŸ›οΈ Product Management: Built-in catalog management to edit products and upload images directly.
  • πŸ” Multi-Tenant: Register an account, get isolated indexes and API keys β€” one deployment serves many businesses.
  • 🧩 Embeddable Widget: paste two lines into any website (Shopify, WordPress, Wix, custom) and get an AI search box for your catalog.
  • πŸ“± Works in apps too: the search API is a plain HTTP call β€” integrate iOS, Android, or any backend in a few dozen lines. See the integration guide.
  • ☁️ Cloud-Native: Dockerized for easy deployment on Google Cloud Run, AWS, or your own server.
  • πŸ”“ Open Source: 100% free to use, modify, and distribute.

πŸ› οΈ Tech Stack

Component Technology Description
Frontend Next.js (React) Modern, responsive admin and search UI.
Backend FastAPI (Python) High-performance API for ingestion and search.
Search Meilisearch Lightning-fast keyword search engine.
Vector DB FAISS Efficient similarity search for embeddings.
Infrastructure Docker Containerized for consistent deployment.

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • Python 3.11+
  • Docker & Docker Compose

Quick Start

  1. Clone the Repository

    git clone https://github.com/dukesky/PolarBear.git
    cd PolarBear
    
  2. Start everything

    cd infrastructure
    docker compose up -d
    

    That's the whole stack β€” Meilisearch, Postgres, the API and the dashboard. Open http://localhost:3000/login and register.

    Set SECRET_KEY before exposing it to anyone: SECRET_KEY=$(openssl rand -hex 32) docker compose up -d

    Prefer to run the services yourself while developing? The three-terminal setup is below.

  3. Start Infrastructure only (development)

    cd infrastructure
    docker compose up -d meilisearch postgres
    
  4. Start Backend (new terminal, from the repository root)

    cd backend
    poetry install
    poetry run uvicorn app.main:app --reload --port 8000
    
  5. Start Frontend (new terminal, from the repository root)

    cd frontend
    npm install
    npm run dev
    
  6. Experience PolarBear

    • Register: Go to http://localhost:3000/login and create an account.
    • Upload Data: Go to http://localhost:3000/upload and upload a CSV (e.g., sample_products.csv).
    • Search: Visit http://localhost:3000/search to try the hybrid search.
    • API Keys: Visit http://localhost:3000/settings to copy your public search key.
    • Embed: In Settings β†’ "Add search to your website", copy the snippet into any web page β€” the widget talks to your backend.
    • Insights: Check http://localhost:3000/insights for analytics and product management.

Upgrading from a pre-multi-tenant version? Indexes are now per-account. After upgrading, register an account and re-upload your CSV β€” old data in the shared products index is not migrated automatically.

πŸ“š Documentation

For store owners & integrators:

  • Integration Guide β€” add PolarBear search to any website (Shopify, WordPress, Wix, custom) in 3 steps; CSV format, widget options, search API, self-hosting, troubleshooting.

Development history β€” detailed walkthroughs for each phase:

🀝 Contributing

We welcome contributions from the community! Whether it's fixing bugs, improving documentation, or suggesting new features, your help is appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

Distributed under the MIT License β€” see LICENSE for the full text.

πŸ“¬ Contact

Project Link: https://github.com/dukesky/PolarBear


Made with ❀️ for the Open Source Community