Skip to content

deepanmpc/SMART-SEARCH

Repository files navigation

Search Wizard Icon

✦ SEARCH WIZARD

Spotlight for your computer.

Search images, videos, audio, and documents using natural language. It's not AI, it's completely AI-free — just pure math with magic.

License: MIT Platform Powered by

Download · Website · Documentation


✨ What is Search Wizard?

Search Wizard is a local search engine that gives your computer a "semantic brain". It's not AI, it's completely AI-free — just pure math with magic. Instead of hunting for filenames, just type what you remember:

"photo of a person wearing blue coolers" "a music that sounds like a lions roar" "screenshot of a pizza recipe from last month" "voice note where I hummed a jazz tune"

It works across images, videos, audio, PDFs, Word docs, and code files using the power of Google Gemini Multimodal Embeddings.


Screenshots

Website Landing Page

Search Wizard Website

Desktop Launcher UI

Search Wizard Launcher


Key Features

  • Semantic Search: Search by meaning, not titles. "sunset at the beach" finds the right file even if it's named IMG_9021.jpg.
  • Multimodal Support: One search for everything. Images, videos, audio, and complex documents (PDF, DOCX).
  • Blazing Fast: Spotlight-style launcher opening in <150ms.
  • Instant Preview: Rich preview pane with thumbnails, text snippets, and metadata.
  • Assistant Mode: Ask questions about your files: ask what do my meeting notes say about our launch date?
  • Privacy First: Everything runs 100% locally. Your files never leave your machine.
  • Keyboard-First: Full navigation with arrows, Space to preview, and Enter to open.

Architecture

graph TD
    A[User Folders] --> B[Auto-Indexing / Watchdog]
    B --> C[Content Extraction]
    C --> D[Gemini API]
    D -->|768d Embeddings| E[FAISS Vector Index]
    C -->|Text Tokens| F[BM25 Keyword Index]
    
    G[User Query] --> H[Gemini API]
    H -->|Query Vector| I[Hybrid Search Engine]
    G -->|Keywords| I
    
    E --> I
    F --> I
    I --> J[Ranked Results & Previews]
Loading

Tech Stack: Electron, FastAPI (Python), Google Gemini (Multimodal Embeddings), FAISS (Vector DB), SQLite (Metadata), BM25 (Keyword Retrieval), Watchdog (Auto-indexing).


Keyboard shortcuts

Shortcut Action
⌘ Shift Space Open / Close Launcher
↑ ↓ Navigate results
Space Preview result
Enter Open file
⌘ R Reveal in Finder / Explorer
Esc Close launcher

Example Queries

Try these in the search bar:

  • photo of a person wearing blue coolers
  • a music that sounds like a lions roar
  • screenshot of a pizza recipe from last month
  • video of me attempting a backflip
  • voice note where I hummed a jazz tune

Privacy & Trust

Search Wizard was built with privacy as a core principle:

  • No File Uploads: Your actual files are never uploaded to any server.
  • Local Database: The vector index (FAISS) and metadata (SQLite) are stored entirely on your computer.
  • API Security: Only short text/image snippets are sent to Google Gemini to generate embeddings.

 macOS Security Note

If you download the .dmg and see a message saying "SEARCH WIZARD is damaged and can't be opened", this is a standard macOS security feature (Gatekeeper) for unsigned applications.

How to fix (COMPULSORY):

  1. Open Terminal on your Mac.
  2. Run this command:
    xattr -cr /Applications/SEARCH\ WIZARD.app
  3. Open the app! It will work perfectly.

Development

# Clone the repo
git clone https://github.com/deepanmpc/SMART-SEARCH.git
cd SMART-SEARCH

# Set up Python 3.11+ backend
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Start the backend
python src/api.py

# In another terminal, start the Electron UI
cd launcher
npm install
npm start

👤 Creator

Deepan Chandrasekaran — AI Engineer building tools for intelligent computing.


License

MIT License. Free for everyone!


⭐ Star this repo if you find it useful!

"This is like Spotlight — but Search Wizard."

About

It makes you search smarter.It can search all the file system including the video ,audio and picture just with natural languages.

Resources

Stars

Watchers

Forks

Packages