mirror of
https://github.com/lancedb/lancedb.git
synced 2026-10-14 07:42:28 +00:00
Move the public website pages into `docs/web` beside the SDK, with
shared navigation and executable example sources in `docs/web-tests`.
The combined website is assembled by
[lancedb/docs#355](https://github.com/lancedb/docs/pull/355), with six
Enterprise replacements from
[lancedb/sophon#7681](https://github.com/lancedb/sophon/pull/7681).
This includes Function guidance, runnable Quickstarts, regenerated
snippets, production contact/demo fixes, the legacy SQL route, and the
LeRobot redirect. LeRobot remains attributed to Geneva; all 34 Geneva
pages remain in the docs repository until Function officially launches.
Materialized-view guidance follows the full rebuild refresh introduced
by #4373: local refresh writes the complete result, has no `full`
argument, supports `source_version`, and no longer requires stable row
IDs. Deployment SQL refresh options and stable-ID setup are qualified by
version/configuration. Function input guidance distinguishes ordinary
stored columns from computed inputs supported by newer deployments.
**Validation:** independently accepted local checks include 95 Python
tests (real Enterprise excluded), eight TypeScript tests, Rust
Quickstart, snippet parity, typos, deterministic assembly, Mint
validation and links/anchors/redirects. The combined baseline retains
all 181 production routes and 17 legacy redirects. Examples ran locally
against source-built Python SDK 0.40.0b13; existing GitHub workflows do
not run `docs/web-tests`. New main at `069b2f7d` is 0.41.0b0 and adds
computed Function inputs; that SDK was not exercised by the accepted
tests. Latest prose corrections receive focused site validation.
**Merge/rollout:** merge this and #7681 before #355's combined CI, which
reads producer `main`. This is migration infrastructure: section
overlays, source-owned skills and automatic versioned paired releases
remain follow-ups. The current manual publisher is transitional. Hosted
validation, a supported SDK/Enterprise release pair and a real
Enterprise walkthrough remain pending.
Production Mintlify watches `lancedb/docs:deploy-freeze`, directory
`docs`; preserve that source through review. The separate SDK GitHub
Pages reference workflow rebuilds on main merges.
**Updated-head CI (9a50f8db):**
[Typos](https://github.com/lancedb/lancedb/actions/runs/37654185443/job/112904990558),
[PR
title](https://github.com/lancedb/lancedb/actions/runs/37654179507/job/112904974595)
and
[Aikido](https://app.aikido.dev/featurebranch/scan/215386145?groupId=74229)
pass. Critical findings in the example lockfiles were patched: all Sharp
copies use 0.35.5, protobufjs 7.6.6, tar 7.5.22, quinn-proto 0.11.19,
zerovec 0.11.8 and zerovec-derive 0.11.6. The SDK's product dependencies
are unchanged. The revised lockfiles pass eight TypeScript examples,
HuggingFace decode/resize/crop/rescale/normalize plus AVIF roundtrip,
and Rust Quickstart. Aikido passing does not mean every advisory is
cleared; npm still reports 29 high and five moderate advisories in the
example dependency graph. No scanner bypass or suppression was added.
The Function prose correction passes combined/standalone Mint,
deterministic assembly, routes and assets. The revised 325-file site
checksum is
`175bec06864abb400dd292e667ba93448c0479b8359fd7bf6146afabf9040647`. This
PR remains open for independent review; further merges are on hold.
---------
Co-authored-by: Brendan Clement <brendan.clement@lancedb.com>
170 lines
8.6 KiB
Plaintext
170 lines
8.6 KiB
Plaintext
---
|
|
title: Sentence Transformers
|
|
sidebarTitle: Sentence Transformers
|
|
---
|
|
|
|
import { PyEmbeddingSentenceTransformersBaai } from '/snippets/integrations.mdx';
|
|
|
|
Allows you to set parameters when registering a `sentence-transformers` object.
|
|
|
|
<Info>
|
|
Sentence transformer embeddings are normalized by default. It is recommended to use normalized embeddings for similarity search.
|
|
</Info>
|
|
|
|
<Warning>
|
|
The `trust_remote_code` parameter defaults to `True`, which allows models to execute arbitrary code from their Hugging Face repository during loading. If you are loading untrusted models, set `trust_remote_code=False` to prevent remote code execution.
|
|
</Warning>
|
|
|
|
| Parameter | Type | Default Value | Description |
|
|
|---|---|---|---|
|
|
| `name` | `str` | `all-MiniLM-L6-v2` | The name of the model |
|
|
| `device` | `str` | `cpu` | The device to run the model on (can be `cpu` or `gpu`) |
|
|
| `normalize` | `bool` | `True` | Whether to normalize the input text before feeding it to the model |
|
|
| `trust_remote_code` | `bool` | `True` | Whether to trust and execute remote code from the model's Huggingface repository |
|
|
|
|
|
|
<Details title="Check out available sentence-transformer models here!">
|
|
```markdown
|
|
- sentence-transformers/all-MiniLM-L12-v2
|
|
- sentence-transformers/paraphrase-mpnet-base-v2
|
|
- sentence-transformers/gtr-t5-base
|
|
- sentence-transformers/LaBSE
|
|
- sentence-transformers/all-MiniLM-L6-v2
|
|
- sentence-transformers/bert-base-nli-max-tokens
|
|
- sentence-transformers/bert-base-nli-mean-tokens
|
|
- sentence-transformers/bert-base-nli-stsb-mean-tokens
|
|
- sentence-transformers/bert-base-wikipedia-sections-mean-tokens
|
|
- sentence-transformers/bert-large-nli-cls-token
|
|
- sentence-transformers/bert-large-nli-max-tokens
|
|
- sentence-transformers/bert-large-nli-mean-tokens
|
|
- sentence-transformers/bert-large-nli-stsb-mean-tokens
|
|
- sentence-transformers/distilbert-base-nli-max-tokens
|
|
- sentence-transformers/distilbert-base-nli-mean-tokens
|
|
- sentence-transformers/distilbert-base-nli-stsb-mean-tokens
|
|
- sentence-transformers/distilroberta-base-msmarco-v1
|
|
- sentence-transformers/distilroberta-base-msmarco-v2
|
|
- sentence-transformers/nli-bert-base-cls-pooling
|
|
- sentence-transformers/nli-bert-base-max-pooling
|
|
- sentence-transformers/nli-bert-base
|
|
- sentence-transformers/nli-bert-large-cls-pooling
|
|
- sentence-transformers/nli-bert-large-max-pooling
|
|
- sentence-transformers/nli-bert-large
|
|
- sentence-transformers/nli-distilbert-base-max-pooling
|
|
- sentence-transformers/nli-distilbert-base
|
|
- sentence-transformers/nli-roberta-base
|
|
- sentence-transformers/nli-roberta-large
|
|
- sentence-transformers/roberta-base-nli-mean-tokens
|
|
- sentence-transformers/roberta-base-nli-stsb-mean-tokens
|
|
- sentence-transformers/roberta-large-nli-mean-tokens
|
|
- sentence-transformers/roberta-large-nli-stsb-mean-tokens
|
|
- sentence-transformers/stsb-bert-base
|
|
- sentence-transformers/stsb-bert-large
|
|
- sentence-transformers/stsb-distilbert-base
|
|
- sentence-transformers/stsb-roberta-base
|
|
- sentence-transformers/stsb-roberta-large
|
|
- sentence-transformers/xlm-r-100langs-bert-base-nli-mean-tokens
|
|
- sentence-transformers/xlm-r-100langs-bert-base-nli-stsb-mean-tokens
|
|
- sentence-transformers/xlm-r-base-en-ko-nli-ststb
|
|
- sentence-transformers/xlm-r-bert-base-nli-mean-tokens
|
|
- sentence-transformers/xlm-r-bert-base-nli-stsb-mean-tokens
|
|
- sentence-transformers/xlm-r-large-en-ko-nli-ststb
|
|
- sentence-transformers/bert-base-nli-cls-token
|
|
- sentence-transformers/all-distilroberta-v1
|
|
- sentence-transformers/multi-qa-MiniLM-L6-dot-v1
|
|
- sentence-transformers/multi-qa-distilbert-cos-v1
|
|
- sentence-transformers/multi-qa-distilbert-dot-v1
|
|
- sentence-transformers/multi-qa-mpnet-base-cos-v1
|
|
- sentence-transformers/multi-qa-mpnet-base-dot-v1
|
|
- sentence-transformers/nli-distilroberta-base-v2
|
|
- sentence-transformers/all-MiniLM-L6-v1
|
|
- sentence-transformers/all-mpnet-base-v1
|
|
- sentence-transformers/all-mpnet-base-v2
|
|
- sentence-transformers/all-roberta-large-v1
|
|
- sentence-transformers/allenai-specter
|
|
- sentence-transformers/average_word_embeddings_glove.6B.300d
|
|
- sentence-transformers/average_word_embeddings_glove.840B.300d
|
|
- sentence-transformers/average_word_embeddings_komninos
|
|
- sentence-transformers/average_word_embeddings_levy_dependency
|
|
- sentence-transformers/clip-ViT-B-32-multilingual-v1
|
|
- sentence-transformers/clip-ViT-B-32
|
|
- sentence-transformers/distilbert-base-nli-stsb-quora-ranking
|
|
- sentence-transformers/distilbert-multilingual-nli-stsb-quora-ranking
|
|
- sentence-transformers/distilroberta-base-paraphrase-v1
|
|
- sentence-transformers/distiluse-base-multilingual-cased-v1
|
|
- sentence-transformers/distiluse-base-multilingual-cased-v2
|
|
- sentence-transformers/distiluse-base-multilingual-cased
|
|
- sentence-transformers/facebook-dpr-ctx_encoder-multiset-base
|
|
- sentence-transformers/facebook-dpr-ctx_encoder-single-nq-base
|
|
- sentence-transformers/facebook-dpr-question_encoder-multiset-base
|
|
- sentence-transformers/facebook-dpr-question_encoder-single-nq-base
|
|
- sentence-transformers/gtr-t5-large
|
|
- sentence-transformers/gtr-t5-xl
|
|
- sentence-transformers/gtr-t5-xxl
|
|
- sentence-transformers/msmarco-MiniLM-L-12-v3
|
|
- sentence-transformers/msmarco-MiniLM-L-6-v3
|
|
- sentence-transformers/msmarco-MiniLM-L12-cos-v5
|
|
- sentence-transformers/msmarco-MiniLM-L6-cos-v5
|
|
- sentence-transformers/msmarco-bert-base-dot-v5
|
|
- sentence-transformers/msmarco-bert-co-condensor
|
|
- sentence-transformers/msmarco-distilbert-base-dot-prod-v3
|
|
- sentence-transformers/msmarco-distilbert-base-tas-b
|
|
- sentence-transformers/msmarco-distilbert-base-v2
|
|
- sentence-transformers/msmarco-distilbert-base-v3
|
|
- sentence-transformers/msmarco-distilbert-base-v4
|
|
- sentence-transformers/msmarco-distilbert-cos-v5
|
|
- sentence-transformers/msmarco-distilbert-dot-v5
|
|
- sentence-transformers/msmarco-distilbert-multilingual-en-de-v2-tmp-lng-aligned
|
|
- sentence-transformers/msmarco-distilbert-multilingual-en-de-v2-tmp-trained-scratch
|
|
- sentence-transformers/msmarco-distilroberta-base-v2
|
|
- sentence-transformers/msmarco-roberta-base-ance-firstp
|
|
- sentence-transformers/msmarco-roberta-base-v2
|
|
- sentence-transformers/msmarco-roberta-base-v3
|
|
- sentence-transformers/multi-qa-MiniLM-L6-cos-v1
|
|
- sentence-transformers/nli-mpnet-base-v2
|
|
- sentence-transformers/nli-roberta-base-v2
|
|
- sentence-transformers/nq-distilbert-base-v1
|
|
- sentence-transformers/paraphrase-MiniLM-L12-v2
|
|
- sentence-transformers/paraphrase-MiniLM-L3-v2
|
|
- sentence-transformers/paraphrase-MiniLM-L6-v2
|
|
- sentence-transformers/paraphrase-TinyBERT-L6-v2
|
|
- sentence-transformers/paraphrase-albert-base-v2
|
|
- sentence-transformers/paraphrase-albert-small-v2
|
|
- sentence-transformers/paraphrase-distilroberta-base-v1
|
|
- sentence-transformers/paraphrase-distilroberta-base-v2
|
|
- sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
|
|
- sentence-transformers/paraphrase-multilingual-mpnet-base-v2
|
|
- sentence-transformers/paraphrase-xlm-r-multilingual-v1
|
|
- sentence-transformers/quora-distilbert-base
|
|
- sentence-transformers/quora-distilbert-multilingual
|
|
- sentence-transformers/sentence-t5-base
|
|
- sentence-transformers/sentence-t5-large
|
|
- sentence-transformers/sentence-t5-xxl
|
|
- sentence-transformers/sentence-t5-xl
|
|
- sentence-transformers/stsb-distilroberta-base-v2
|
|
- sentence-transformers/stsb-mpnet-base-v2
|
|
- sentence-transformers/stsb-roberta-base-v2
|
|
- sentence-transformers/stsb-xlm-r-multilingual
|
|
- sentence-transformers/xlm-r-distilroberta-base-paraphrase-v1
|
|
- sentence-transformers/clip-ViT-L-14
|
|
- sentence-transformers/clip-ViT-B-16
|
|
- sentence-transformers/use-cmlm-multilingual
|
|
- sentence-transformers/all-MiniLM-L12-v1
|
|
```
|
|
</Details>
|
|
|
|
<Info>
|
|
You can also load many other model architectures from the library. For example models from sources such as BAAI, Nomic, Salesforce Research, etc. See this HF hub page for all [supported models](https://huggingface.co/models?library=sentence-transformers).
|
|
</Info>
|
|
|
|
<Note title="BAAI embeddings example">
|
|
Here is an example that uses the BAAI embedding model from the Hugging Face Hub [supported models](https://huggingface.co/models?library=sentence-transformers).
|
|
|
|
<CodeGroup>
|
|
<CodeBlock filename="Python" language="Python" icon="python">
|
|
{PyEmbeddingSentenceTransformersBaai}
|
|
</CodeBlock>
|
|
</CodeGroup>
|
|
</Note>
|
|
Visit sentence-transformers [HuggingFace HUB](https://huggingface.co/sentence-transformers) page for more information on the available models.
|
|
|