Skip to main content

What is CosmaSense?

CosmaSense is an open-source local file indexing and search engine that finds your files using natural language queries. It runs 100% locally on your device, giving you powerful semantic search capabilities without compromising your privacy. Think of it as Google for your file system - no more digging through folders or trying to remember exact filenames. Just search for what’s in the file, and CosmaSense will find it.

Get started

Install CosmaSense and start searching your files in minutes.

Key Features

Hybrid Search

Combines semantic (vector) and keyword (FTS5) search for the best results.

AI-Powered Summaries

Automatically generates titles, summaries, and keywords for your files.

100% Local

All processing happens on your device. Your data never leaves your computer.

Multiple Interfaces

Available as a TUI (Terminal UI), CLI, and soon a native macOS app.

Supported File Types

CosmaSense can parse and index over 20 file formats including:
  • Documents: PDF, DOCX, TXT, MD
  • Images: PNG, JPG, GIF (with OCR)
  • Code: Python, JavaScript, Java, and more
  • Spreadsheets: XLSX, CSV
  • And many more via MarkItDown

Technical Highlights

Backend Architecture

Built with Quart async framework, SQLite with vector search, and sentence-transformers.

Real-time Updates

Automatically watches directories and re-indexes files as they change.

Smart Processing

4-stage pipeline: Discovery → Parsing → Summarization → Embedding

Open Source

Available on GitHub under an open-source license.