// devtools · MinishLab/semble

semble

semble é um projeto de ferramentas de desenvolvimento de código aberto de MinishLab (MinishLab/semble no GitHub). Tem 6.192 estrelas no GitHub e 273 forks, é publicado sob a licença MIT e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

Fast, accurate semantic code search for agents — about 99% fewer tokens than grep plus read.

★ 6,2 mil estrelas⑂ 273 forksMITatualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Repositório
MinishLab/semble
Estrelas no GitHub
6.192
Forks
273
Licença
MIT
Última atualização no GitHub
8 de outubro de 2026
Tipo de ficha
Guia de instalação completo
Site oficial
Official site
// como funciona

Como funciona

  1. Clarify what your agent wastes time on

    If your agent burns tokens grepping and reading files to find code, Semble is the retrieval layer that replaces that.

  2. Install Semble

    Install it as a uv tool and run the installer to wire it into your agent.

  3. Configure the integration

    Choose the MCP server, CLI instructions, or the dedicated semble-search sub-agent for your agent setup.

  4. Run your first search

    Search a local path or a remote git URL in natural language and inspect the returned chunks and your token savings.

// recursos

Por que as pessoas gostam tanto

Semantic plus lexical retrieval

Combines embedding search with lexical matching, adaptively weighting symbol-like queries versus natural-language questions.

MCP server for agents

Runs as an MCP server with search and find_related tools; repos are indexed on demand and cached, and local paths re-index on file changes.

Token efficient by design

Returns only relevant chunks instead of whole files — the project reports about 99% fewer tokens than grep+read, and semble savings shows your totals.

Fast on CPU

Indexes an average repo in about 500 ms and answers queries in about 1 ms on CPU, per the project's benchmarks.

Local and remote repos

Search a local directory, an https git URL, or several repos at once; content types include code, docs, config or all.

Zero-setup operation

No API keys, GPU or external services required; a .sembleignore file controls what gets indexed.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone the repository

    Clone Semble if you want the source; most users install the tool in the next step.

    git clone https://github.com/MinishLab/semble.git
    cd semble
  2. Install Semble

    Install it as a uv tool and run its installer to set up your agent integration.

    uv tool install semble
    semble install
  3. Search a codebase

    Search a local repo (the index is built and cached automatically) or a remote one.

    semble search "authentication flow" ./my-project
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains Semble?

Semble is maintained by MinishLab (the Minish team), with docs at minish.ai.

Is Semble free?

Yes — it is open source under the MIT license.

Does it need a paid API key?

No. Semble runs locally on CPU with its own models and needs no API keys, GPU or external services.

How does it compare to grep or a vector database?

Grep matches text only and forces the agent to read whole files; Semble returns ranked, relevant chunks from a semantic index, purpose-built for agent consumption.

How do I get started?

uv tool install semble, run semble install, then semble search with a natural-language query against your repo.

// continue explorando

Ferramentas semelhantes

Ferramentas de desenvolvimento

grepai

grepai: semantic code search and call graphs for AI agents, running 100% locally on your machine.

★ 1,9 mil estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

cocoindex-code

Lightweight AST-based semantic code search CLI (ccc) that makes coding agents faster and cheaper

★ 2,8 mil estrelasApache-2.0
Ver o guia →
Ferramentas de desenvolvimento

ygrep

Fast, local, indexed code search built for AI assistants.

★ 60 estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

probe

Semantic code search for AI — ripgrep speed with tree-sitter AST parsing.

★ 722 estrelasApache-2.0
Ver o guia →
Ferramentas de desenvolvimento

SocratiCode

Enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally.

★ 3,3 mil estrelasAGPL-3.0
Ver o guia →
Ferramentas de desenvolvimento

zvec-grep

zvec-grep (zg): one local CLI unifying ripgrep-style exact search, BM25, and semantic vector search

★ 4,0 mil estrelasApache-2.0
Ver o guia →
// alternativas

Alternativas em Ferramentas de desenvolvimento

Os outros projetos de Ferramentas de desenvolvimento com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se semble não for o ideal para você.

// mais em devtools

Mais em Ferramentas de desenvolvimento

Projetos de Ferramentas de desenvolvimento próximos no catálogo, os mais próximos em estrelas de semble: continue explorando dos dois lados dele.

Baixe o semble

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.