link-r
pip install uu-link-r → import link_r (Python ≥ 3.12, one abi3 wheel per
platform).
A tiny, embeddable crawl-and-resolve link index. Give it a parent URL: it crawls sublinks to a configurable depth, distills keywords and topics from each page, and builds a compact hybrid index (dense embeddings + BM25 + metadata filters). Queries resolve to ranked remote URLs — document bodies stay at the URL and are fetched lazily by the caller.
import link_r
idx = link_r.LinkIndex.open_or_create("kb.lnkr")
idx.update("https://docs.example.com/", depth=2)
idx.save()
for hit in idx.search("how does auth work", k=10):
print(f"{hit.score:.3f} {hit.url}")
# Keep the knowledge base fresh: 304s are free, dead links are evicted.
idx.refresh(ttl_secs=86_400)
- Zero-copy. The on-disk index is the file: search runs against mapped pages with no deserialization step, verified byte-reproducible.
- Hybrid retrieval. Dense embeddings (deterministic hash embedder by
default; ONNX
bge-smallbehind theonnxfeature) fused with BM25 via reciprocal-rank fusion, with categorical prefilters and an optional link-graph boost. - Conditional everything. Stored
ETags becomeIf-None-Match; an unchanged page answers304and transfers no body, and previously indexed links keep the crawl frontier alive through it. - Credential-safe. Tokens are host-scoped, stripped on cross-host redirects, never rendered in debug output; URL userinfo is never persisted.
- Thread-safe. Blocking calls detach from the interpreter; driving the
index through
asyncio.to_threadis the intended pattern. Oneabi3wheel per platform (Python ≥ 3.12).
Dual-licensed AGPL-3.0-or-later / commercial (contact spicyzhug@gmail.com).
1 maintainer
Metadata
1 maintainer
Release files for uu-link-r 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| uu_link_r-0.4.0.tar.gz | 429.9 kB | With provenance | Details for uu_link_r-0.4.0.tar.gz |
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| uu_link_r-0.4.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details for uu_link_r-0.4.0-cp312-abi3-win_amd64.whl |
| uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ x86-64 | Details for uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_x86_64.whl |
| uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ ARM64 | Details for uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_aarch64.whl |
| uu_link_r-0.4.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details for uu_link_r-0.4.0-cp312-abi3-macosx_11_0_arm64.whl |
| uu_link_r-0.4.0-cp312-abi3-macosx_10_12_x86_64.whl | CPython 3.12 | abi3 | macOS 10.12+ x86-64 | Details for uu_link_r-0.4.0-cp312-abi3-macosx_10_12_x86_64.whl |
Total release size: 13.3 MB
Release files / uu_link_r-0.4.0.tar.gz
| Download URL | uu_link_r-0.4.0.tar.gz |
|---|---|
| Size | 429.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cf7c331cea9d56ad05e3c691be6acadcbea165d96c902b5ca599b9f8f747984a
|
|
BLAKE2b-256 checksum How to use checksums |
93aa82ecc9c9a74928945900a3f9ced5e634d68c44908a7ec0d1e289c98b0d7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / uu_link_r-0.4.0-cp312-abi3-win_amd64.whl
| Download URL | uu_link_r-0.4.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
347faa6a8d4873064dff1985acc51fd93bc2ace6c6b93a892d05a564b23ad9a3
|
|
BLAKE2b-256 checksum How to use checksums |
05457987d23ca362e8ecede3109fff550348add8db577a66d8e9f1ebf8619bac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_x86_64.whl
| Download URL | uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
4987417685d6f438331fa1542ebd3c2c572efe1800a8d7bab912c0903beb2cef
|
|
BLAKE2b-256 checksum How to use checksums |
2e3f35641b2354922e8c01b1f0abb0be387446b45e8ccd116185b1e3b0c46da8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | uu_link_r-0.4.0-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
7ffd44460bba5f43257f22bacb11e26bfb398aa62cbcbbad1bd344416b1b6777
|
|
BLAKE2b-256 checksum How to use checksums |
0973aafbfbd6c27383280b3b4074334935e4ab94d0d4c496705085f2948b727a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / uu_link_r-0.4.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | uu_link_r-0.4.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
059cea14986e02b77c6e7154b6e727b3f392be11e26ee556ae198a9e35ce4625
|
|
BLAKE2b-256 checksum How to use checksums |
5a375e584fd90107ddd401b9e6c7e6f6ffc9d13ed4acf4f517301e2ae574f909
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / uu_link_r-0.4.0-cp312-abi3-macosx_10_12_x86_64.whl
| Download URL | uu_link_r-0.4.0-cp312-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.12 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
5cc5cf430cf1d5faac84e96a6f3fbfece078a995a4a9db03aec7aea5e61b2e46
|
|
BLAKE2b-256 checksum How to use checksums |
97f366789f551bb076df43e7e42fb72c80366273fd65b649dae80e1b9c721c4d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logSecurity for uu-link-r 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 6 files in this release have been uploaded with provenance metadata.
Attestation for uu_link_r-0.4.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
