Get Started
Install Sercha CLI on your platform and start searching locally in minutes
Homebrew (Recommended)
Install via Homebrew tap
brew tap custodia-labs/sercha
brew install serchaNote
On first run, macOS may block the binary. If you see 'killed', run:
xattr -d com.apple.quarantine $(which sercha)Need help getting started?
View Getting Started GuideFeatures
Everything you need for powerful local search
Privacy First
All searches happen locally on your machine. Your data never leaves your control or touches external servers.
Lightning Fast
Optimized for speed with CGO-enabled performance. Search through millions of records in milliseconds.
Cross-Platform
Native builds for macOS (Intel & Apple Silicon), Linux (x86_64 & ARM64), and Windows.
Open Source
Fully open source under Apache 2.0 license. Audit the code, contribute improvements, or fork for your needs.
Configurable
Customize search behavior, indexing options, and output formats to match your workflow perfectly.
Well Documented
Comprehensive documentation, guides, and examples to help you get started and make the most of Sercha.
Unified Search Across All Sources
One simple command searches across all your connected services. No flags, no complexity - just search everywhere at once.
Search across Gmail, Notion, GitHub, Dropbox, and more
$ sercha search "Q4 budget discussion"Automatic result merging
Results from all sources ranked by relevance
Cross-source deduplication
Smart filtering of duplicate results
Optional filtering
Narrow by source, date, or file type when needed
Unified Search Results
Results from all sources in one view
Supported Connectors
Search across your personal accounts and services. All connectors support individual use with local indexing.
Gmail
Search through your personal Gmail inbox and sent emails. Find messages, attachments, and conversations instantly.
Use Cases
Find all emails about the Q4 budget from last month
$ sercha search "Q4 budget" --source gmail --from "1 month ago"Search for emails with PDF attachments
$ sercha search --source gmail --filter "has:attachment filetype:pdf"Find that confirmation email from your bank
$ sercha search "confirmation" --source gmail --from "bank.com"Search Interface
Results Detail
AI-Enhanced Search (Optional)
Bring your own LLM and embedding models to unlock semantic search and AI-assisted queries. Works out of the box with fast BM25 full-text search - AI is optional.
Default: Fast BM25 Search
Sercha works perfectly with traditional full-text search. Fast, accurate, and requires no API keys or external services.
Optional AI Upgrade
Connect your own AI models to unlock advanced features:
- Semantic Search: Find results by meaning, not just keywords
- LLM-Assisted Queries: Natural language understanding and query expansion
- Hybrid Search: Combine BM25 + semantic similarity for best results
Supported AI Providers
Configuration Example
# Optional: Configure AI
export SERCHA_LLM_ENDPOINT="..."
export SERCHA_EMBEDDING_ENDPOINT="..."
export OPENAI_API_KEY="..."
# Search works with or without AI
sercha search "your query"Semantic Search Results
Ready to dive deeper?
Explore our comprehensive documentation and guides