aifs

Local semantic search. Stupidly simple.

open-sourcememory-knowledge
452
Stars
+0
Stars/month
0
Releases (6m)

Star Growth

443452461Mar 27Apr 1

Overview

aifs (AI Filesystem) is a local semantic search tool that enables fast, intelligent searching across folders containing mixed file types. It automatically chunks and embeds documents using state-of-the-art parsing and embedding models, storing the results in a local `_.aifs` index file for lightning-fast subsequent searches. The tool supports a wide range of file formats including text files, code, documents, images, and PDFs. Built on top of Unstructured for parsing and Chroma for embedding, aifs intelligently updates its index when files are modified or added, making it ideal for searching dynamic folders like codebases or document repositories. The tool was specifically designed to enable semantic search capabilities for AI tools like open-interpreter, but serves as a general-purpose solution for anyone needing semantic search over local file collections. Its minimalist approach focuses on being the best local semantic search solution rather than expanding into broader functionality.

Deep Analysis

Key Differentiator

vs cloud search tools: operates entirely locally with zero external API calls — semantic search over any local folder with multi-format support, from Open Interpreter team

Capabilities

  • Local semantic search across folders without external API calls
  • Automatic file chunking and embedding with local index
  • Support for diverse file types: txt, py, sh, docx, pptx, jpg, png, eml, html, pdf
  • Nested directory search with persistent local index
  • Google Colab compatible for cloud experimentation

🔗 Integrations

unstructured (document parsing)Chroma (local embedding)pip

Best For

  • Semantic search across local code repositories and documentation
  • Privacy-preserving document search without cloud dependencies
  • Mixed format document collections needing intelligent retrieval

Not Ideal For

  • Cloud-based collaborative search
  • Real-time file system monitoring
  • Frequently deleted file scenarios

Languages

Python

Deployment

pip installlocal CLIGoogle Colab

Known Limitations

  • Does not handle file deletions (deleted files remain in index)
  • Requires initial indexing time before fast searches
  • Limited to supported file formats

Pros

  • + Extremely fast searches after initial indexing due to local embedding storage
  • + Supports comprehensive file format coverage including code, documents, images and PDFs
  • + Intelligent incremental updates - only re-indexes changed or new files

Cons

  • - Large dependency footprint when installing full document parsing support
  • - Does not yet handle file deletions from the index
  • - Initial indexing can be time-consuming for large folders

Use Cases

  • Semantic search across mixed codebases to find relevant functions or documentation
  • Searching document repositories with various file types (PDFs, Word docs, presentations)
  • Integration with AI development tools that need semantic file search capabilities

Getting Started

Install with `pip install aifs` and optionally `pip install "unstructured[all-docs]"` for full document type support. Import the search function with `from aifs import search`. Start searching with `search("your query", path="/path/to/folder")` or use current directory by default.

Compare aifs