Skip to content

ndx-video/faind

Repository files navigation

fAInd - AI-Powered File Search

Find anything on your computer in seconds with the power of AI.

fAInd revolutionizes how you search for files on your computer. Instead of digging through endless folders or trying to remember exact file names, simply describe what you're looking for in natural language and let AI do the work.

✨ What fAInd Does

πŸ” Smart Search

  • Natural Language: Search by saying "presentation from last week" or "photos from vacation"
  • Multiple Filters: Combine text, file types, dates, sizes, and locations in one search
  • Instant Results: Get results as you type with lightning-fast performance
  • AI Suggestions: Get smart recommendations to refine your search

🎯 Intelligent Discovery

  • Content Understanding: Find files by what's inside them, not just their names
  • Smart Categories: Automatically organize results by relevance and type
  • Pattern Recognition: Learn from your search habits to show better results
  • Duplicate Detection: Identify and manage duplicate files across your system

πŸ’» Works Everywhere

  • Desktop App: Native application for Windows, macOS, and Linux
  • Web Interface: Use in any browser for quick searches
  • Live Editing: Developers can customize the interface in real-time with Onlook
  • Cross-Platform: Your search preferences sync across all devices

πŸš€ Key Features

Build Your Search Visually

Create complex searches using an intuitive block-based interface:

  • Text Contains: Find files with specific words or phrases
  • File Type: Filter by documents, images, videos, code files, etc.
  • Location: Search specific folders or your entire computer
  • Date Range: Find files created or modified within specific timeframes
  • File Size: Filter by file size ranges
  • Advanced Patterns: Use powerful regex patterns for expert users

Save Time with Presets

  • Quick Access: Save frequently used searches for one-click access
  • Smart Suggestions: AI recommends useful search combinations
  • Recent Searches: Quickly re-run your most recent searches
  • Shared Presets: Import search configurations from colleagues

Powerful Results

  • Rich Previews: See file contents, thumbnails, and metadata at a glance
  • Quick Actions: Open, reveal in folder, copy path, or share directly from results
  • Bulk Operations: Perform actions on multiple files at once
  • Export Options: Save search results for later reference

🎨 Perfect for Everyone

Home Users

  • Find family photos, documents, downloads, and media files instantly
  • Organize your digital life without complex folder structures
  • Recover "lost" files you know exist but can't locate

Professionals

  • Locate project files, presentations, and documents across multiple folders
  • Search through years of work files in seconds
  • Find specific versions of documents or files by content

Developers

  • Search through codebases by function names, comments, or file types
  • Find configuration files, logs, and documentation quickly
  • Customize the interface using Onlook for team-specific workflows

Students & Researchers

  • Find research papers, notes, and assignments by topic or content
  • Organize academic materials without rigid folder hierarchies
  • Search through large collections of PDFs and documents

πŸ› οΈ How It Works

  1. Index Your Files: fAInd safely scans your computer to build a searchable index
  2. Describe What You Want: Type natural language queries or use visual search blocks
  3. Get Smart Results: AI understands your intent and shows the most relevant files
  4. Take Action: Open, organize, or share files directly from the search results

Privacy First

  • Local Processing: All AI processing happens on your computer
  • No Data Upload: Your files and searches never leave your device
  • Secure Access: Advanced security measures protect your personal information
  • You Control: Choose which folders to include or exclude from indexing

πŸ“± Available Platforms

Desktop Applications

  • Windows: Native Windows app with system integration
  • macOS: Mac app with Spotlight-like functionality
  • Linux: AppImage for universal Linux compatibility

Web Interface

  • Any Browser: Access through your web browser
  • Developer Tools: Live editing capabilities with Onlook integration
  • Responsive Design: Works on desktop, tablet, and mobile devices

🎯 Current Status

What's Working Now

  • βœ… Beautiful Interface: Modern, intuitive search interface
  • βœ… Desktop App: Native Electron application for all platforms
  • βœ… Visual Search Builder: Block-based query construction
  • βœ… Live Editing: Real-time interface customization with Onlook
  • βœ… Developer Ready: Full TypeScript codebase with modern tooling

Coming Soon

  • πŸ”„ Real File Search: Currently uses demo data, real search engine in development
  • πŸ”„ AI Integration: Natural language processing and smart suggestions
  • πŸ”„ File Indexing: Automatic background indexing of your files
  • πŸ”„ Advanced Features: Bulk operations, file management, and more

πŸš€ Getting Started

For Users

  1. Download: Get the latest version for your operating system
  2. Install: Simple one-click installation process
  3. First Run: Choose which folders to include in your search index
  4. Start Searching: Begin finding your files with natural language

For Developers

  1. Clone Repository: git clone https://github.com/ndx-video/faind.git
  2. Install Dependencies: Follow the setup guide in the documentation
  3. Start Development: Use Onlook for live interface editing
  4. Contribute: Help build the future of file search

πŸ“š Learn More

🀝 Contributing

fAInd is open source and welcomes contributions! Whether you're fixing bugs, adding features, or improving documentation, your help makes fAInd better for everyone.

Ways to Contribute

  • Report Issues: Found a bug? Let us know!
  • Suggest Features: Have ideas for improvements?
  • Write Code: Help implement new features and fixes
  • Improve Docs: Make our documentation clearer and more helpful
  • Test & Feedback: Try new features and share your experience

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Why fAInd?

In a world where we create and download thousands of files, traditional folder-based organization breaks down. fAInd brings the power of modern AI to file search, making it as easy to find a file as it is to remember what you're looking for.

Stop hunting through folders. Start finding with fAInd.


Built with ❀️ by the NDX Video team

About

fAInd is an AI app for finding stuff on your computer.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published