mlx embeddings

Incorporações MLX

MLX-Embeddings é um pacote para executar modelos de Vision e Language Embedding localmente em seu Mac usando MLX.

• Software gratuito: Licença Pública Geral GNU v3

Características

• Gere embeddings para texto usando modelos MLX
• Suporte para processamento de item único e em lote
• Utilitários para comparar semelhanças de texto

Instalação

Você pode instalar embeddings mlx usando pip:

pip install mlx-embeddings

Uso

Incorporação de item único

Para gerar uma incorporação para um único trecho de texto:

 import mlx . core as mx
from mlx_embeddings . utils import load

# Load the model and tokenizer
model , tokenizer = load ( "sentence-transformers/all-MiniLM-L6-v2" )

# Prepare the text
text = "I like reading"

# Tokenize and generate embedding
input_ids = tokenizer . encode ( text , return_tensors = "mlx" )
outputs = model ( input_ids )
embeddings = outputs [ 0 ][:, 0 , :]

Comparando Vários Textos

Para comparar vários textos usando seus embeddings:

 from sklearn . metrics . pairwise import cosine_similarity
import matplotlib . pyplot as plt
import seaborn as sns
import mlx . core as mx
from mlx_embeddings . utils import load

# Load the model and tokenizer
model , tokenizer = load ( "sentence-transformers/all-MiniLM-L6-v2" )

def get_embedding ( text , model , tokenizer ):
    input_ids = tokenizer . encode ( text , return_tensors = "mlx" , padding = True , truncation = True , max_length = 512 )
    outputs = model ( input_ids )
    embeddings = outputs [ 0 ][:, 0 , :][ 0 ]
    return embeddings

# Sample texts
texts = [
    "I like grapes" ,
    "I like fruits" ,
    "The slow green turtle crawls under the busy ant."
]

# Generate embeddings
embeddings = [ get_embedding ( text , model , tokenizer ) for text in texts ]

# Compute similarity
similarity_matrix = cosine_similarity ( embeddings )

# Visualize results
def plot_similarity_matrix ( similarity_matrix , labels ):
    plt . figure ( figsize = ( 5 , 4 ))
    sns . heatmap ( similarity_matrix , annot = True , cmap = 'coolwarm' , xticklabels = labels , yticklabels = labels )
    plt . title ( 'Similarity Matrix Heatmap' )
    plt . tight_layout ()
    plt . show ()

labels = [ f"Text { i + 1 } " for i in range ( len ( texts ))]
plot_similarity_matrix ( similarity_matrix , labels )

Processamento em lote

Para processar vários textos de uma vez:

 from sklearn . metrics . pairwise import cosine_similarity
import matplotlib . pyplot as plt
import seaborn as sns
import mlx . core as mx
from mlx_embeddings . utils import load

# Load the model and tokenizer
model , tokenizer = load ( "sentence-transformers/all-MiniLM-L6-v2" )

def get_embedding ( texts , model , tokenizer ):
    inputs = tokenizer . batch_encode_plus ( texts , return_tensors = "mlx" , padding = True , truncation = True , max_length = 512 )
    outputs = model (
        inputs [ "input_ids" ],
        attention_mask = inputs [ "attention_mask" ]
    )
    return outputs [ 0 ]

def compute_and_print_similarity ( embeddings ):
    B , Seq_len , dim = embeddings . shape
    embeddings_2d = embeddings . reshape ( B , - 1 )
    similarity_matrix = cosine_similarity ( embeddings_2d )

    print ( "Similarity matrix between sequences:" )
    print ( similarity_matrix )
    print ( " n " )

    for i in range ( B ):
        for j in range ( i + 1 , B ):
            print ( f"Similarity between sequence { i + 1 } and sequence { j + 1 } : { similarity_matrix [ i ][ j ]:.4f } " )

    return similarity_matrix

# Sample texts
texts = [
    "I like grapes" ,
    "I like fruits" ,
    "The slow green turtle crawls under the busy ant."
]

embeddings = get_embedding ( texts , model , tokenizer )
similarity_matrix = compute_and_print_similarity ( embeddings )

# Visualize results
labels = [ f"Text { i + 1 } " for i in range ( len ( texts ))]
plot_similarity_matrix ( similarity_matrix , labels )

Arquiteturas de modelos suportados

MLX-Embeddings oferece suporte a uma variedade de arquiteturas de modelo para tarefas de incorporação de texto. Aqui está um detalhamento das arquiteturas atualmente suportadas:

• XLM-RoBERTa (modelo de linguagem multilíngue - abordagem BERT robustamente otimizada)
• BERT (representações de codificador bidirecional de transformadores)

Estamos trabalhando continuamente para expandir nosso suporte a arquiteturas de modelos adicionais. Verifique nosso repositório GitHub ou documentação para obter a lista mais atualizada de modelos suportados e suas versões específicas.

Contribuindo

Contribuições para MLX-Embeddings são bem-vindas! Consulte nossas diretrizes de contribuição para obter mais informações.

Licença

Este projeto está licenciado sob a Licença Pública Geral GNU v3.

Contato

Para qualquer dúvida ou problema, abra um problema no repositório GitHub.