explaingit

unary-works/unfoldly

Analysis updated 2026-05-18

4PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A local desktop app that lets you find personal files, photos, and videos by describing what you remember about them, instead of needing the exact filename.

Mindmap

mindmap
  root((repo))
    What it does
      Search by memory
      Indexes chosen folders
      Ask follow up questions
    Tech stack
      Python
      Tauri
      ChromaDB
      TypeScript
    Use cases
      Find a forgotten photo
      Locate a video moment
      Ask questions about a spreadsheet
    Audience
      General users
      Vibe coders
    Privacy
      Runs locally
      Files never uploaded
      Local vector store

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find a photo or video by describing what is in it instead of remembering its filename.

USE CASE 2

Ask follow-up questions about a spreadsheet, document, or presentation after finding it.

USE CASE 3

Search across documents, images, audio, and video files all in one place.

USE CASE 4

Keep personal file search and indexing entirely on your own computer.

What is it built with?

PythonTauriChromaDBTypeScript

How does it compare?

unary-works/unfoldlyadeliox/klein-head-swapats4321/ragit
Stars444
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity2/53/52/5
Audiencegeneraldesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Current public build is macOS only and unnotarized, so macOS security settings must be adjusted the first time it runs.

Apache 2.0 lets you use, modify, and distribute the code freely, including commercially, as long as you keep the license notice.

In plain English

Unfoldly is a local desktop application that lets you search your personal files using natural language, the way you actually remember things, rather than requiring exact filenames or keywords. Instead of asking what a file is called, you can describe what you remember about it: the photo of your dog on the beach, the video where you saw a manta ray, or the spreadsheet that explains why a trip went over budget. The app works by indexing the files and folders you choose, extracting text, visual signals, metadata, and searchable embeddings from each file type. Once indexed, you can search by memory or meaning, and then ask follow-up questions about the file you find, with the app keeping the source document in context for the conversation. The full search and chat process runs locally, so your files are never uploaded anywhere. Supported file types span a wide range: documents such as PDF, DOCX, and TXT, spreadsheets including XLSX and CSV, slides in formats like PPTX and Keynote, images in JPG, PNG, HEIC, and others, audio files, video in formats like MP4 and MOV, and structured files like JSON and YAML. Under the hood, Unfoldly runs a Python backend with ChromaDB as its local vector store, uses local GGUF format AI models for language understanding, and wraps everything in a Tauri based desktop shell with a frontend built in TypeScript. The current public release is for macOS only and is in early beta. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me download and set up Unfoldly on my Mac to search my personal files.
Prompt 2
Explain how Unfoldly finds a photo or video based on what I remember about it.
Prompt 3
Walk me through what file types Unfoldly can index and search.
Prompt 4
Show me how to fully uninstall Unfoldly and remove its local data using the uninstall script.

Frequently asked questions

What is unfoldly?

A local desktop app that lets you find personal files, photos, and videos by describing what you remember about them, instead of needing the exact filename.

What language is unfoldly written in?

Mainly Python. The stack also includes Python, Tauri, ChromaDB.

What license does unfoldly use?

Apache 2.0 lets you use, modify, and distribute the code freely, including commercially, as long as you keep the license notice.

How hard is unfoldly to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is unfoldly for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.