Your Mac screenshots folder is a disaster. This fixes it — with vision, embeddings, and semantic search.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"snapsearch-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<div align="center"> <img src="https://raw.githubusercontent.com/shantanukumar22/snapsearch/main/src/snapsearch/search-svg.svg" alt="snapsearch logo" width="120"> <h1>snapsearch</h1> <p><strong>Your Mac screenshots folder is a disaster. This fixes it — with vision, embeddings, and semantic search.</strong></p> <p> <a href="https://pypi.org/project/snapsearch/"><img src="https://img.shields.io/pypi/v/snapsearch.svg" alt="PyPI Version"></a> <a href="https://pypi.org/project/snapsearch/"><img src="https://img.shields.io/pypi/pyversions/snapsearch.svg" alt="Python Versions"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a> </p> </div> An AI agent + custom MCP server that **sees** your screenshots, understands what's in them, organizes them into clean folders, and lets you find anything with natural language. **Fully local. No cloud uploads. No subscriptions.** --- ## ✨ Features - **Context-Aware Organization**: Unlike scripts that blindly rename files, this agent understands context and categorizes intelligently. - **Semantic Search**: Find screenshots by meaning (e.g., *"that slack message about the deploy"*), even with garbage filenames. - **Adaptive**: Tell it to *"actually split design into figma vs other"* and it re-organizes on the fly. - **Persistent Memory**: Decisions are remembered across sessions using a local ChromaDB. --- ## 🚀 Quickstart (No Clone Needed!) Using `uvx` (the modern Python alternative to `npx`), you can run **snapsearch** instantly without manual cloning or pip installs. ### 1. Set your Environment Variables You need to provide your OpenAI API key and optionally your screenshots directory. You can set them in your environment: ```bash export OPENAI_API_KEY="sk-..." export SCREENSHOTS_DIR="/Users/yourname/Desktop" # Optional, defaults to ~/Desktop/screenshots-demo ``` ### 2. Run the Agent Trigger the autonomous organizer r…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.