This is a proof of concept to show that BART can be used to enhance search in Paperless-ngx. It originates from the proposal discussion here.
This project is experimental, so expect rough edges.
Currently you can run the script by preparing the development environment (poetry install, documented below) and running
# you must provide credentials to access the paperless server
# see https://docs.paperless-ngx.com/api/#authorization for details
# go to "$PAPERLESS_BASE_URL/admin/authtoken/tokenproxy/" to create a token
export PAPERLESS_BASE_URL="http://..."
export PAPERLESS_TOKEN="abcd1234..."
# the hook provides a DOCUMENT_ID to specify which document was just consumed
export DOCUMENT_ID="1"
# and finally, you can run the hook
poetry run post_consume_scriptNote: this will almost certainly have to change to improve portability.
This project uses Python 3.11+ and Poetry. Assuming you have these installed, preparing the developing environment should just be:
poetry installYou can run the unit tests with
pytest tests/