Mira

From Latin mīrāre - to look, to see, to behold.

Mira is a local-first desktop application that turns your folders into a searchable, intelligent workspace. Search files in plain English - no exact filenames required.

---

Install

Download the latest macOS build from the GitHub Releases page.

1. Open the .dmg and drag Mira into Applications.

2. Because Mira is not yet notarized by Apple, macOS will show "Mira is damaged and can't be opened" on first launch. Remove the quarantine flag by running this once in Terminal:

   xattr -cr /Applications/Mira.app

3. Launch Mira from Applications.

---

Demo

mira_compressed.mp4

---

Features

• Metadata search - instantly query file names, types, sizes, and dates across indexed folders
• Content extraction - full-text search inside PDFs, documents, and text files
• Semantic search - meaning-based retrieval powered by local embeddings by default, with an optional Gemini API provider
• Live indexing - add a source folder and Mira begins indexing in the background immediately
• File preview - open or reveal any result directly from the app

---

How it works

1. Add a source - point Mira at any folder on your machine
2. Index - Mira walks the directory tree, records file metadata, extracts text from supported formats, and generates semantic embeddings
3. Search - queries are matched against metadata, extracted text, and semantic meaning simultaneously, then ranked by relevance

By default, processing happens locally and your files never leave your device. If you enable the optional Gemini API provider in settings, Mira sends the content needed for embeddings to Google's API using the key you provide.

---

---

Mira - look deeper into your files.

---

---

Building from source

Prerequisites: Rust, Bun, and the Tauri v2 system dependencies for your OS.

# Install dependencies
bun install

# Run in development (hot-reload)
bun run tauri dev

# Build for production
bun run tauri build

The distributable will be in src-tauri/target/release/bundle/.