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.37.tar.gz (48.5 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.37-py3-none-any.whl (11.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.37.tar.gz
Algorithm Hash digest
SHA256 c621947fa8e77f46f97f7d7cecc42325b84acee0f02bfd25affc5e4a9694aa8f
MD5 f88dcbdb0869425a38eddd392ccac422
BLAKE2b-256 26254f5ee98cacb2c9f92ad6fdf1bc75c2eabd7445362970d84e1016213deee8

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.37-py3-none-any.whl
Algorithm Hash digest
SHA256 b9202c22ad074a15a756931cd84521a7997236067093dc61c80d32d3124e2ddf
MD5 b421b0d601453bafbe6b1007dae86527
BLAKE2b-256 d70e3ae5c6c13ab1ac23de31e933157d78b82cdbd21807d9f789a748dff1dcc1

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