# dtsola/xiaoyaosearch

小遥搜索，听懂你的话、看懂你的图，用AI找到本地任何文件。让搜索像聊天一样简单。XiaoyaoSearch: Understands your words, reads your images, finds any local file with AI. Making search as easy as chatting.

Repository: https://github.com/dtsola/xiaoyaosearch
Canonical: https://ross.abutalabs.com/products/xiaoyaosearch
Homepage: https://project.xiaoyaosai.com
Language: Python
License: NOASSERTION
License Family: other
Topics: agent-skills, ai-search, document-search, file-search, local-search, mcp, multimodal-ai, natural-language, semantic-search, productivity
Last push: 2026-05-22T09:48:18+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 83, release rhythm 81, longevity 21
- inputs: {"age_days": 295, "days_push": 103, "days_rel": 131, "gap_med": 6.5, "n_releases_24m": 13}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1083, forks 60 (observed 2026-08-28T04:03:31.133374+00:00)

## What it is
XiaoyaoSearch is a cross-platform desktop application (Electron + Python/FastAPI) that lets users find local files using AI-powered semantic search with text, voice, or image queries. It combines hybrid retrieval (Faiss vector search + Whoosh full-text) with models like BGE-M3, FasterWhisper, and CN-CLIP to index and search documents, audio, and video entirely on the local machine, and exposes itself as an MCP server and Agent Skill for AI assistants.

## Use cases
- find any file on my computer by describing it in natural language
- search the contents of pdf, office, and markdown documents locally with AI
- search local files by speaking instead of typing
- locate a video or audio file by what is said or shown in it
- find files using an image as the search query
- let Claude Desktop or Cursor search my local files through MCP
- run private semantic file search offline without uploading my data
- improve recall for domain jargon and synonyms when searching documents

## When to choose
- you need AI-powered search over your own local files with strong privacy (local-first, optional cloud APIs)
- you want multimodal querying - voice, text, or image - against documents, audio, and video
- you work with Chinese-language content and want models like BGE-M3/CN-CLIP plus a terminology library
- you want to give AI assistants (Claude Desktop, Claude Code, Cursor) standardized access to local file search via MCP or Agent Skills

## When to avoid
- you need an OSI-approved open-source license for commercial use - commercial deployment requires separate authorization
- you need server-side or multi-user enterprise search across a network rather than a single-user desktop tool
- your machine cannot run local AI models and you are unwilling to depend on cloud embedding/LLM APIs
- you want a lightweight file indexer without downloading AI models or index-building overhead

## Facets
- artifact type: application
- maturity: active
- function: search-engine, speech-recognition, nlp, machine-learning, llm-inference, mcp
- domain: desktop-applications, developer-tools, files, artificial-intelligence
- platform: windows, cross-platform, python
- tags: semantic-search, local-search, file-search, multimodal-ai, voice-search, hybrid-search, vector-search, faiss, whoosh, ollama, mcp-server, agent-skills, electron-app, privacy-first, chinese-language, search, natural-language-processing, macos, linux, desktop

## Member repositories
- dtsola/xiaoyaosearch (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:31.133374+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:51:10.053126+00:00, confidence not recorded.
  - readme: https://github.com/dtsola/xiaoyaosearch (fetched 2026-08-28T04:03:31.133374+00:00, sha c0e171debf71)
  - homepage: https://project.xiaoyaosai.com (fetched 2026-08-29T12:53:32.726021+00:00, sha f26bf9c5317a)
  - site_page: https://project.xiaoyaosai.com/about (fetched 2026-08-29T12:53:32.735259+00:00, sha da94d1cfd1a7)
- Data as of 2026-08-30T08:39:29.467469+00:00.