mem0ai/mem0

feat(ts-sdk): add HuggingFace embedding provider

Open

#5.769 aberto em 23 de jun. de 2026

Ver no GitHub
 (1 comment) (0 reactions) (0 assignees)Python (6.343 forks)batch import
enhancementgood first issuehelp wantedsdk-typescriptsize:M

Métricas do repositório

Stars
 (55.741 stars)
Métricas de merge de PR
 (Mesclagem média 6d 11h) (208 fundiu PRs em 30d)

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).

Guia do colaborador

Direção de pesquisa
Siga o padrão de referência em `embeddings/openai.ts` para criar `huggingface.ts`. Registre o provedor em `factory.ts`, adicione tipos, escreva um teste unitário e atualize `package.json`.
Pilha de tecnologia
typescript
Domain
backend
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
TypeScriptNode.js
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
75