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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for chercher-0.1.38.tar.gz
Algorithm Hash digest
SHA256 024dc9a97c6c1342ad1c8fc34cbd4f4e06e68ee2ffa7eb31796bc7e7e089907c
MD5 e112e255f8f20d0727c25489d412832c
BLAKE2b-256 b6e5473c49fdaea159eb79500039f1556dd2b55b869504ee5847d1fdcacb591e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: chercher-0.1.38-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.38-py3-none-any.whl
Algorithm Hash digest
SHA256 4c9c2f3205873355a66bdc9972b8403a0b4094082b84fb65bebc0bc5e2a96198
MD5 e763932f985c4f3737a8f12be793902a
BLAKE2b-256 a03b0d326b7b4233b5bad8ecbae394f4d939dbcc3cbbbbc856a23c5e5cd0e565

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