Repolode
Enviar
MinishLab

MinishLab/semble

Biblioteca de búsqueda de código para agentes de programación con IA que devuelve solo fragmentos relevantes y funciona en CPU, sin claves de API.

Ver en GitHubSitio web
Estrellas
6,361
Forks
286
Issues abiertos
7
Último commit
hace 3 días

¿Qué es?

Semble es una biblioteca de búsqueda de código diseñada para agentes de programación como Claude Code, Cursor y Codex. A partir de una consulta en lenguaje natural o código, devuelve los fragmentos coincidentes de un repositorio, en lugar de hacer que el agente busque palabras clave con grep y lea archivos completos, lo que reduce los tokens que consume explorando el código.

Divide los archivos en fragmentos teniendo en cuenta la estructura del código mediante tree-sitter y evalúa cada consulta con dos sistemas de recuperación: embeddings estáticos de Model2Vec para la similitud semántica y BM25 para encontrar coincidencias en nombres de identificadores y API. Combina los resultados con Reciprocal Rank Fusion y los vuelve a ordenar con señales como bonificaciones para las definiciones y penalizaciones para los archivos de pruebas. Los índices se guardan en caché y se actualizan de forma incremental cuando cambian los archivos.

Semble se puede usar como servidor MCP, como CLI con integración para AGENTS.md o a través de su API de Python. Acepta rutas locales o URL de Git, permite buscar en varios repositorios a la vez y admite contenido de código, documentación y configuración.

Funciones clave

  • 01Devuelve fragmentos de código ordenados por relevancia para consultas en lenguaje natural o código.
  • 02Funciona en CPU sin necesidad de claves de API, GPU ni servicios externos.
  • 03Ofrece un servidor MCP con herramientas de búsqueda y localización de elementos relacionados.
  • 04Incluye una CLI y una biblioteca de Python para scripts y herramientas personalizadas.
  • 05Busca en varios repositorios Git locales o remotos como si fueran un solo corpus.
  • 06Respeta .gitignore y .sembleignore, y actualiza los índices de forma incremental.

Casos de uso

  • Permitir que un agente de programación encuentre las funciones relevantes antes de editar una base de código extensa.
  • Buscar un endpoint o una definición en varios repositorios de microservicios.
  • Reducir el consumo de tokens de flujos de trabajo con agentes que, de otro modo, usarían grep y leerían archivos completos.
  • Automatizar búsquedas de código en CI o en entornos aislados sin llamadas a API por red.

Inicio rápido

  1. 1

    Instala uv (consulta la guía de instalación de uv)

  2. 2

    Instala semble como herramienta de uv

    uv tool install semble
  3. 3

    Ejecuta el instalador interactivo para configurar las integraciones de agentes

    semble install

Antes de usarlo

  • El README indica que la primera vez que se usa se descarga un modelo de embeddings específico desde Hugging Face, por lo que se necesita conexión a Internet una vez.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCP

Temas

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

Preguntas frecuentes

¿Qué es semble?
Biblioteca de búsqueda de código para agentes de programación con IA que devuelve solo fragmentos relevantes y funciona en CPU, sin claves de API. Semble es una biblioteca de búsqueda de código diseñada para agentes de programación como Claude Code, Cursor y Codex. A partir de una consulta en lenguaje natural o código, devuelve los fragmentos coincidentes de un repositorio, en lugar de hacer que el agente busque palabras clave con grep y lea archivos completos, lo que reduce los tokens que consume explorando el código.
¿semble es gratuito? ¿Qué licencia tiene?
semble es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿semble sigue mantenido?
Mantenimiento activo. El último commit de semble fue el 3 nov 2026.
¿Para qué puedo usar semble?
Permitir que un agente de programación encuentre las funciones relevantes antes de editar una base de código extensa. Buscar un endpoint o una definición en varios repositorios de microservicios. Reducir el consumo de tokens de flujos de trabajo con agentes que, de otro modo, usarían grep y leerían archivos completos. Automatizar búsquedas de código en CI o en entornos aislados sin llamadas a API por red.
¿Cómo se instala semble?
Instala uv (consulta la guía de instalación de uv) Instala semble como herramienta de uv: uv tool install semble Ejecuta el instalador interactivo para configurar las integraciones de agentes: semble install
¿Dónde consigo semble?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/MinishLab/semble

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados