Skip to main content

Universal and personal search engine.

Project description

🔍 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chercher-0.1.34.tar.gz (47.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chercher-0.1.34-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

Details for the file chercher-0.1.34.tar.gz.

File metadata

  • Download URL: chercher-0.1.34.tar.gz
  • Upload date:
  • Size: 47.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.7.3

File hashes

Hashes for chercher-0.1.34.tar.gz
Algorithm Hash digest
SHA256 f4e76b543762942751ad6735c1ac727c100ecb27e03c665d7260f93135cf9442
MD5 c4f37d48275c01a80d42edf11170fa49
BLAKE2b-256 58c7a9bb143cf5726817831873cde677c9900d30563873265f70f0a1ed531bc1

See more details on using hashes here.

File details

Details for the file chercher-0.1.34-py3-none-any.whl.

File metadata

  • Download URL: chercher-0.1.34-py3-none-any.whl
  • Upload date:
  • Size: 10.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.7.3

File hashes

Hashes for chercher-0.1.34-py3-none-any.whl
Algorithm Hash digest
SHA256 f8ff5242967f757adff1fe4375ae279b77ab318195acc5496faaaad8f49700a6
MD5 fd354d089726aa37c64a8eb12bde2df3
BLAKE2b-256 bdd0d324f39402413047501a40cb742e5011491c6c5dbd9304b79484c0439708

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page