Skip to main content

🔍 Chercher - My Universal Search Engine

Chercher is my personal search engine for everything. It chews through PDFs, ebooks, YouTube videos, RSS feeds, and my own notes to help me rediscover anything I've seen, read, or written. Built on top of SQLite, it's designed to be fast enough for daily use and simple enough that I can extend it whenever I need to.

Features

  • Pluggable architecture that adapts to your needs:

  • Building your own plugins is minutes:

    • Starter template with Cookiecutter
    • Simple Python interface (just implemented the methods you want.)
  • BM25-powered search at SQLite speed:

    • Industry-standard ranking algorithm
    • Supports advanced query operators
  • Progressive indexing:

    • Files become searchable immediately
    • No full-rebuilds required
    • Stop and resume anytime
    • Handles incremental updates gracefully
  • Terminal-native workflow:

    • Easy-to-use CLI with intuitive commands
    • Structured output for quick scanning
    • Pipe-friendly for power users (WIP)
  • And more coming soon:

    • Modern TUI (WIP)
    • Auto-suggestion engine (WIP)
    • Granular search filters (WIP)
    • Hook for incremental updates (WIP)

Motivation

Building my own personal search engine has been a recurring project that never quite stuck. My first attempt, winzig, taught me about the basics but felt too rigid. Then housaku became an over-engineered lesson in scope creep. But with each iteration, I learned what really matters for me and a great deal about search engines in general.

Chercher is the distillation of those lessons.

Installion

[!NOTE] TODO

Usage

[!NOTE] TODO

Metadata

Release files for chercher 0.1.38

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chercher 0.1.38
File Size Uploaded
chercher-0.1.38.tar.gz 48.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for chercher 0.1.38
File Interpreter ABI Platform
chercher-0.1.38-py3-none-any.whl Python 3 none any Details

Total release size: 59.8 kB

Release files / chercher-0.1.38.tar.gz

Download URL chercher-0.1.38.tar.gz
Size 48.2 kB
Tags Source
SHA-256 checksum
How to use checksums
024dc9a97c6c1342ad1c8fc34cbd4f4e06e68ee2ffa7eb31796bc7e7e089907c
BLAKE2b-256 checksum
How to use checksums
b6e5473c49fdaea159eb79500039f1556dd2b55b869504ee5847d1fdcacb591e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.7.5

Release files / chercher-0.1.38-py3-none-any.whl

Download URL chercher-0.1.38-py3-none-any.whl
Size 11.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4c9c2f3205873355a66bdc9972b8403a0b4094082b84fb65bebc0bc5e2a96198
BLAKE2b-256 checksum
How to use checksums
a03b0d326b7b4233b5bad8ecbae394f4d939dbcc3cbbbbc856a23c5e5cd0e565
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.7.5
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page