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.33.tar.gz (47.2 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.33-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.33.tar.gz
Algorithm Hash digest
SHA256 6698cdb494a0debf753fedf972b45c93bddb8f0064863d0ae0f70c8ad5931e4e
MD5 bfa4b5fa518e118dc536f44092712050
BLAKE2b-256 d1173463cc2be9967154abfc8e9f715d0f4bf3db642171f1e2dba50338c38582

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.33-py3-none-any.whl
Algorithm Hash digest
SHA256 26ac213d2921b59bde843ee4c65dd6dd9adcdaf600f290ae822dcf59c89753b2
MD5 91a46d5a751987b6faf0f55bed11f9d0
BLAKE2b-256 9481879400d5dee0660435ad38d76f5ae5f5326ac32c634fa47d26ae636c1b45

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