Skip to content

feat: wire fast-plaid as the plaid optional dependency (#335)#418

Open
MushiSenpai wants to merge 1 commit into
illuin-tech:mainfrom
MushiSenpai:feat/fast-plaid-optional-dependency-335
Open

feat: wire fast-plaid as the plaid optional dependency (#335)#418
MushiSenpai wants to merge 1 commit into
illuin-tech:mainfrom
MushiSenpai:feat/fast-plaid-optional-dependency-335

Conversation

@MushiSenpai

Copy link
Copy Markdown

Closes #335.

In #335, @ManuelFay noted the issues that previously blocked integrating fast-plaid
are now fixed and suggested wiring it in directly:

we can just add the dep in the pyproject.toml and modify the readme!

This does exactly that (the volunteer who offered to take it went quiet a while back,
so I picked it up).

Changes

  • pyproject.toml — add a plaid optional-dependency group and include it in all:
    plaid = ["fast-plaid>=1.4.7,<2.0.0", "fastkmeans"]
  • README.md — replace the experimental manual install
    (# !pip install --no-deps fast-plaid fastkmeans) with the supported extra
    (pip install "colpali-engine[plaid]") and drop the "experimentally" caveat.

Compatibility

fast-plaid 1.4.7.x requires torch==2.11.0, which is inside the project's existing
torch>=2.2.0,<2.12.0 pin, and pulls fastkmeans==0.5.0 transitively. The PLAID
helpers (create_plaid_index / get_topk_plaid) already exist in the codebase — this
only wires the install path. Happy to tighten or loosen the version bound if you prefer.


Disclosure: drafted with AI assistance (Claude); reviewed, tested, and submitted by me. The commit carries a Co-Authored-By trailer.

…#335)

Per the maintainer note in illuin-tech#335 (the compatibility issues that previously
blocked integration are now fixed), expose fast-plaid through a `plaid`
optional-dependency group instead of the manual `--no-deps` install in the README.

- pyproject.toml: add `plaid = ["fast-plaid>=1.4.7,<2.0.0", "fastkmeans"]` and
  include it in the `all` group.
- README: replace the experimental `--no-deps fast-plaid fastkmeans` snippet with
  `pip install "colpali-engine[plaid]"` and drop the "experimentally" caveat.

fast-plaid 1.4.7.x requires torch==2.11.0, which sits inside the project's
existing torch>=2.2.0,<2.12.0 pin.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

fast-plaid Updated: Now Compatible with PyTorch 2.6-2.8

1 participant