Repolode
jkrup

jkrup/jeveryword

Biblioteca JavaScript sem dependências que usa o modelo de múltipla escolha Jev, da TypeSafe, para extrair trechos exatos, valores de campos e rótulos de PII de mensagens curtas.

Estrelas
42
Forks
3
Issues abertas
0
Último commit
há 2 meses

O que é?

jeveryword permite usar o modelo Jev, da TypeSafe, para extração de texto. O Jev só responde a perguntas de múltipla escolha e não consegue gerar texto; por isso, a biblioteca numera as palavras da entrada, oferece esses números como opções de resposta e mapeia os números escolhidos de volta para a substring original usando offsets de caracteres. Assim, todo valor retornado é um trecho literal da entrada, e cada resultado inclui uma probabilidade que pode ajudar a decidir quais valores devem ser confirmados com o usuário.

Os principais helpers são extractSpans, para campos nomeados definidos por descrições em linguagem natural, e classifyChunks com mergeChunks, para rotular cada palavra, por exemplo, com categorias de PII. Uma API tokenize de nível mais baixo permite criar perguntas personalizadas. O pacote não tem dependências, roda no Node 20+, Cloudflare Workers, Deno e Bun, e inclui um cliente de modelo simulado para testes. Também é descrita uma API HTTP hospedada, cobrada por chamada em USDC via x402.

O projeto é marcado como experimental, e seus autores relatam ter feito testes apenas com um pequeno conjunto de mensagens sintéticas. Ele é adequado para textos curtos processados em tempo real e não é uma boa opção para documentos longos ou valores que precisam ser calculados ou reformatados.

Recursos principais

  • 01Extrai campos nomeados de textos e retorna substrings exatas com offsets de início e fim.
  • 02Informa quando há valores ausentes ou ambíguos, além de uma probabilidade para cada resultado.
  • 03Rotula cada palavra com uma categoria de PII ou personalizada e une palavras rotuladas adjacentes em trechos.
  • 04Disponibiliza uma API tokenize de baixo nível para criar perguntas de múltipla escolha personalizadas.
  • 05Não tem dependências em tempo de execução e roda no Node, Deno, Bun e Cloudflare Workers.

Casos de uso

  • Extrair nomes, e-mails ou números de pedido de mensagens de suporte ou formulários de cadastro.
  • Destacar dados pessoais em mensagens curtas de chat antes de armazená-las ou exibi-las.
  • Criar uma etapa de revisão em que o usuário confirma extrações com baixa probabilidade.
  • Executar extrações de textos curtos a partir de um agente de programação ou de uma função serverless.

Início rápido

  1. 1

    Instale o pacote pelo npm

    npm install jeveryword
  2. 2

    Defina sua chave de API da TypeSafe como uma variável de ambiente

    export TYPESAFE_API_KEY=…
  3. 3

    Importe extractSpans e createJevClient e execute a extração no seu texto (consulte o exemplo no README)

Antes de usar

  • O README o descreve como experimental e informa que foi verificado apenas com um pequeno conjunto de mensagens sintéticas, sem benchmarks.
  • Para executá-lo, é necessária uma chave de API da TypeSafe, e cada chamada é cobrada pelo preço de tabela da Jev.
  • Requer Node 20 ou superior.

Em coleções

Tópicos

Perguntas frequentes

O que é jeveryword?
Biblioteca JavaScript sem dependências que usa o modelo de múltipla escolha Jev, da TypeSafe, para extrair trechos exatos, valores de campos e rótulos de PII de mensagens curtas. jeveryword permite usar o modelo Jev, da TypeSafe, para extração de texto. O Jev só responde a perguntas de múltipla escolha e não consegue gerar texto; por isso, a biblioteca numera as palavras da entrada, oferece esses números como opções de resposta e mapeia os números escolhidos de volta para a substring original usando offsets de caracteres. Assim, todo valor retornado é um trecho literal da entrada, e cada resultado inclui uma probabilidade que pode ajudar a decidir quais valores devem ser confirmados com o usuário.
jeveryword é gratuito? Qual é a licença?
jeveryword é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
jeveryword ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de jeveryword foi em 20 de set. de 2026.
Para que posso usar jeveryword?
Extrair nomes, e-mails ou números de pedido de mensagens de suporte ou formulários de cadastro. Destacar dados pessoais em mensagens curtas de chat antes de armazená-las ou exibi-las. Criar uma etapa de revisão em que o usuário confirma extrações com baixa probabilidade. Executar extrações de textos curtos a partir de um agente de programação ou de uma função serverless.
Como instalar jeveryword?
Instale o pacote pelo npm: npm install jeveryword Defina sua chave de API da TypeSafe como uma variável de ambiente: export TYPESAFE_API_KEY=… Importe extractSpans e createJevClient e execute a extração no seu texto (consulte o exemplo no README)
Onde consigo jeveryword?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jkrup/jeveryword

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados