Repolode
Enviar
MinishLab

MinishLab/semble

Biblioteca de busca de código para agentes de programação com IA que retorna apenas os trechos relevantes, roda na CPU e não exige chaves de API.

Ver no GitHubSite
Estrelas
6,367
Forks
286
Issues abertas
7
Último commit
há 4 dias

O que é?

Semble é uma biblioteca de busca de código criada para agentes de programação como Claude Code, Cursor e Codex. Dada uma consulta em linguagem natural ou código, ela retorna os trechos correspondentes de um repositório, em vez de fazer o agente buscar palavras-chave com grep e ler arquivos inteiros, reduzindo os tokens gastos na exploração.

A biblioteca divide os arquivos em trechos que levam em conta a estrutura do código, usando tree-sitter, e avalia cada consulta com dois mecanismos de recuperação: embeddings estáticos do Model2Vec para similaridade semântica e BM25 para correspondências de identificadores e nomes de APIs. Os resultados são combinados com Reciprocal Rank Fusion e reordenados com sinais como reforço para definições e penalizações para arquivos de teste. Os índices são armazenados em cache e atualizados incrementalmente quando os arquivos mudam.

Semble pode ser usado como servidor MCP, como CLI com integração via AGENTS.md ou pela API de Python. Aceita caminhos locais ou URLs git, permite pesquisar vários repositórios em conjunto e oferece suporte a conteúdo de código, documentação e arquivos de configuração.

Recursos principais

  • 01Retorna trechos de código classificados para consultas em linguagem natural ou código.
  • 02Roda na CPU, sem exigir chaves de API, GPU ou serviços externos.
  • 03Oferece um servidor MCP com ferramentas de busca e localização de itens relacionados.
  • 04Inclui uma CLI e uma biblioteca Python para scripts e ferramentas personalizadas.
  • 05Pesquisa vários repositórios git locais ou remotos como um único corpus.
  • 06Respeita .gitignore e .sembleignore e atualiza os índices incrementalmente.

Casos de uso

  • Permitir que um agente de programação encontre as funções relevantes antes de editar uma base de código grande.
  • Pesquisar vários repositórios de microsserviços para encontrar um endpoint ou uma definição.
  • Reduzir o uso de tokens em fluxos de trabalho de agentes que, de outro modo, usariam grep e leriam arquivos inteiros.
  • Automatizar buscas de código em CI ou ambientes isolados, sem chamadas a APIs pela rede.

Início rápido

  1. 1

    Instale o uv (consulte o guia de instalação do uv)

  2. 2

    Instale o semble como uma ferramenta do uv

    uv tool install semble
  3. 3

    Execute o instalador interativo para configurar as integrações de agentes

    semble install

Antes de usar

  • O README informa que, no primeiro uso, um modelo de embeddings específico é baixado do Hugging Face, o que exige conexão com a Internet uma vez.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCP

Tópicos

#code-search#agents#mcp#embeddings#retrieval#bm25#developer-tools#mcp-server#model-context-protocol

Perguntas frequentes

O que é semble?
Biblioteca de busca de código para agentes de programação com IA que retorna apenas os trechos relevantes, roda na CPU e não exige chaves de API. Semble é uma biblioteca de busca de código criada para agentes de programação como Claude Code, Cursor e Codex. Dada uma consulta em linguagem natural ou código, ela retorna os trechos correspondentes de um repositório, em vez de fazer o agente buscar palavras-chave com grep e ler arquivos inteiros, reduzindo os tokens gastos na exploração.
semble é gratuito? Qual é a licença?
semble é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
semble ainda é mantido?
Manutenção ativa. O último commit de semble foi em 3 de nov. de 2026.
Para que posso usar semble?
Permitir que um agente de programação encontre as funções relevantes antes de editar uma base de código grande. Pesquisar vários repositórios de microsserviços para encontrar um endpoint ou uma definição. Reduzir o uso de tokens em fluxos de trabalho de agentes que, de outro modo, usariam grep e leriam arquivos inteiros. Automatizar buscas de código em CI ou ambientes isolados, sem chamadas a APIs pela rede.
Como instalar semble?
Instale o uv (consulte o guia de instalação do uv) Instale o semble como uma ferramenta do uv: uv tool install semble Execute o instalador interativo para configurar as integrações de agentes: semble install
Onde consigo semble?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MinishLab/semble

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

Projetos relacionados