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.29.tar.gz (25.6 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.29-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.29.tar.gz
Algorithm Hash digest
SHA256 249d0a340137b68c12cf70c4e7ffe0c50af2745857f3d48acaed37b5a260076c
MD5 2c40bb8458e56ad95c82e5adbb33831f
BLAKE2b-256 9950491dc1eb55f1bce17c5e0afa6aca2cdb0c2a71b5f9dfd2d71d905ca297dd

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.29-py3-none-any.whl
Algorithm Hash digest
SHA256 f894feb0dea83dd4df7ab66da721f7b23daf036d0c8034afcdcc6738386f3c17
MD5 3de9a593e0550cffa4891bb4ce6eb55f
BLAKE2b-256 eb6400251881c510ba632863e1c53ba6f450ebcf6c486c711ddb499c9599fa93

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