mem0ai/mem0

feat(ts-sdk): add HuggingFace embedding provider

Open

#5 769 ouverte le 23 juin 2026

Voir sur GitHub
 (1 commentaire) (0 réactions) (0 assignés)Python (6 343 forks)batch import
enhancementgood first issuehelp wantedsdk-typescriptsize:M

Métriques du dépôt

Stars
 (55 741 stars)
Métriques de merge PR
 (Merge moyen 6j 11h) (208 PRs mergées en 30 j)

Description

Summary

The Python SDK supports HuggingFace as an embedding provider, but the TypeScript OSS SDK (mem0ai/oss) does not. Add it to bring the TS SDK to parity.
Python reference mem0/embeddings/huggingface.py
Registered in (Python) mem0/utils/factory.py (EmbedderFactory)
Target file (TypeScript) mem0-ts/src/oss/src/embeddings/huggingface.ts
Suggested implementation API mode: @huggingface/inference. Optional local mode: @huggingface/transformers (transformers.js).

Requirements

  • Implement HuggingFaceEmbedder in mem0-ts/src/oss/src/embeddings/huggingface.ts, extending Embedder (mem0-ts/src/oss/src/embeddings/base.ts) and mirroring the Python provider's behavior (embed / embedBatch).
  • Register the "huggingface" provider in mem0-ts/src/oss/src/utils/factory.ts (EmbedderFactory).
  • Add config typing in mem0-ts/src/oss/src/types/.
  • Add a unit test under mem0-ts/src/oss/src/tests/.
  • Add @huggingface/inference to mem0-ts/package.json (optional/peer dependency, lazy-imported like other providers).
  • Update docs under docs/ if this provider is user-facing.

Reference pattern

Mirror an existing TS provider: embeddings/openai.ts.

Notes

Python defaults to LOCAL sentence-transformers. Start with the HF Inference API for hosted-model parity; a local transformers.js path can follow. Document which models are supported.

Part of the TypeScript ↔ Python SDK provider-parity effort. One provider per issue (atomic).

Guide contributeur

Direction de recherche
Suivez le modèle de référence dans `embeddings/openai.ts` pour créer `huggingface.ts`. Enregistrez le fournisseur dans `factory.ts`, ajoutez les types, écrivez un test unitaire et mettez à jour `package.json`.
Stack technique
typescript
Domaine
backend
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
TypeScriptNode.js
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
75