@mastra/fastembed 1.3.0 → 1.3.1-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -59
- package/dist/fastembed.d.ts.map +1 -1
- package/dist/index.cjs +3 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/package.json +7 -8
- package/CHANGELOG.md +0 -259
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@ This package is a maintained fork of [fastembed-js](https://github.com/Anush008/
|
|
|
7
7
|
## Installation
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
|
|
10
|
+
npm install @mastra/fastembed
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
## Usage
|
|
@@ -24,66 +24,14 @@ const memory = new Memory({
|
|
|
24
24
|
});
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
## Documentation
|
|
28
28
|
|
|
29
|
-
|
|
30
|
-
import { fastembed } from '@mastra/fastembed';
|
|
31
|
-
|
|
32
|
-
// Default export (bge-small-en-v1.5 with v3 spec)
|
|
33
|
-
const embedder = fastembed;
|
|
34
|
-
|
|
35
|
-
// Named exports for v3 models
|
|
36
|
-
const small = fastembed.small; // bge-small-en-v1.5
|
|
37
|
-
const base = fastembed.base; // bge-base-en-v1.5
|
|
38
|
-
|
|
39
|
-
// Multilingual E5 (1024 dimensions), one model per role
|
|
40
|
-
const e5Query = fastembed.multilingualE5LargeQuery; // multilingual-e5-large-query
|
|
41
|
-
const e5Passage = fastembed.multilingualE5LargePassage; // multilingual-e5-large-passage
|
|
42
|
-
|
|
43
|
-
// V2 models (for AI SDK v5 compatibility)
|
|
44
|
-
const smallV2 = fastembed.smallV2;
|
|
45
|
-
const baseV2 = fastembed.baseV2;
|
|
46
|
-
|
|
47
|
-
// Legacy v1 models (for backwards compatibility)
|
|
48
|
-
const smallLegacy = fastembed.smallLegacy; // bge-small-en-v1.5 (v1 spec)
|
|
49
|
-
const baseLegacy = fastembed.baseLegacy; // bge-base-en-v1.5 (v1 spec)
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### Direct Usage with AI SDK
|
|
53
|
-
|
|
54
|
-
```typescript
|
|
55
|
-
import { embed } from 'ai';
|
|
56
|
-
import { fastembed } from '@mastra/fastembed';
|
|
57
|
-
|
|
58
|
-
const result = await embed({
|
|
59
|
-
model: fastembed,
|
|
60
|
-
value: 'Text to embed',
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
console.log(result.embedding); // number[]
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
## Supported Models
|
|
67
|
-
|
|
68
|
-
| Model | Dimensions | Description |
|
|
69
|
-
| ------------------------------- | ---------- | ---------------------------------------------- |
|
|
70
|
-
| `bge-small-en-v1.5` | 384 | Fast, default English model |
|
|
71
|
-
| `bge-base-en-v1.5` | 768 | Base English model |
|
|
72
|
-
| `bge-small-en` | 384 | Fast English model |
|
|
73
|
-
| `bge-base-en` | 768 | Base English model |
|
|
74
|
-
| `bge-small-zh-v1.5` | 512 | Fast Chinese model |
|
|
75
|
-
| `all-MiniLM-L6-v2` | 384 | Sentence Transformer model |
|
|
76
|
-
| `multilingual-e5-large-query` | 1024 | Multilingual model, for embedding search text |
|
|
77
|
-
| `multilingual-e5-large-passage` | 1024 | Multilingual model, for embedding indexed text |
|
|
29
|
+
- [Use FastEmbed for local semantic recall](https://mastra.ai/docs/memory/semantic-recall#using-fastembed-local)
|
|
78
30
|
|
|
79
|
-
|
|
31
|
+
## Changelog
|
|
80
32
|
|
|
81
|
-
|
|
82
|
-
text. The two roles are exposed as separate models and must be used as a pair — index your documents
|
|
83
|
-
with `multilingualE5LargePassage` and embed searches with `multilingualE5LargeQuery`. Mixing the
|
|
84
|
-
roles, or mixing E5 vectors with BGE vectors in one index, silently degrades retrieval quality. The
|
|
85
|
-
target vector index must be created with 1024 dimensions.
|
|
33
|
+
See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/packages/fastembed/CHANGELOG.md) for version history and release notes.
|
|
86
34
|
|
|
87
|
-
##
|
|
35
|
+
## Support
|
|
88
36
|
|
|
89
|
-
|
|
37
|
+
We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.
|
package/dist/fastembed.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fastembed.d.ts","sourceRoot":"","sources":["../src/fastembed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,oBAAY,iBAAiB;IAC3B,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,oBAAY,cAAc;IACxB,aAAa,0BAA0B;IACvC,SAAS,qBAAqB;IAC9B,YAAY,0BAA0B;IACtC,UAAU,sBAAsB;IAChC,aAAa,2BAA2B;IACxC,UAAU,2BAA2B;IACrC,SAAS,+BAA+B;IACxC,MAAM,WAAW;CAClB;AAED,oBAAY,oBAAoB;IAC9B,YAAY,+BAA+B;IAC3C,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAmBD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACtD,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC;IAC7B,oBAAoB,EAAE,QAAQ,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAElE,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,KAAK,EAAE,OAAO,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAClE,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC;IACnC,oBAAoB,EAAE,QAAQ,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAEpF,uBAAe,SAAS;IACtB,QAAQ,CAAC,mBAAmB,IAAI,SAAS,EAAE;
|
|
1
|
+
{"version":3,"file":"fastembed.d.ts","sourceRoot":"","sources":["../src/fastembed.ts"],"names":[],"mappings":"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"}
|
package/dist/index.cjs
CHANGED
|
@@ -8154,7 +8154,7 @@ ZodNullable$2.create;
|
|
|
8154
8154
|
ZodEffects$1.createWithPreprocess;
|
|
8155
8155
|
ZodPipeline$1.create;
|
|
8156
8156
|
//#endregion
|
|
8157
|
-
//#region ../_vendored/ai_v5/dist/dist-
|
|
8157
|
+
//#region ../_vendored/ai_v5/dist/dist-Dqv4QeJJ.js
|
|
8158
8158
|
var marker$1$6 = "vercel.ai.error";
|
|
8159
8159
|
var symbol$1$7 = Symbol.for(marker$1$6);
|
|
8160
8160
|
var _a$1$7;
|
|
@@ -16322,7 +16322,7 @@ let customAlphabet = (alphabet, defaultSize = 21) => {
|
|
|
16322
16322
|
return (size = defaultSize) => {
|
|
16323
16323
|
let id = "";
|
|
16324
16324
|
let i = size | 0;
|
|
16325
|
-
while (i--) id += alphabet[Math.random() * alphabet.length | 0];
|
|
16325
|
+
while (i-- > 0) id += alphabet[Math.random() * alphabet.length | 0];
|
|
16326
16326
|
return id;
|
|
16327
16327
|
};
|
|
16328
16328
|
};
|
|
@@ -23167,7 +23167,7 @@ function _instanceof(cls, params = { error: `Input not instance of ${cls.name}`
|
|
|
23167
23167
|
return inst;
|
|
23168
23168
|
}
|
|
23169
23169
|
//#endregion
|
|
23170
|
-
//#region ../_vendored/ai_v6/dist/dist-
|
|
23170
|
+
//#region ../_vendored/ai_v6/dist/dist-Cx98_f-i.js
|
|
23171
23171
|
var marker$1 = "vercel.ai.error";
|
|
23172
23172
|
var symbol$1 = Symbol.for(marker$1);
|
|
23173
23173
|
var _a$1;
|