// devtools · giancarloerra/SocratiCode

SocratiCode

SocratiCode é um projeto de ferramentas de desenvolvimento de código aberto de giancarloerra (giancarloerra/SocratiCode no GitHub). Tem 3.336 estrelas no GitHub e 428 forks, é publicado sob a licença AGPL-3.0 e foi atualizado pela última vez no GitHub em 7 de outubro de 2026.

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

★ 3,3 mil estrelas⑂ 428 forksAGPL-3.0atualizado 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

Estrelas no GitHub
3.336
Forks
428
Licença
AGPL-3.0
Última atualização no GitHub
7 de outubro de 2026
Tipo de ficha
Guia de instalação completo
Site oficial
Official site
// como funciona

Como funciona

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// recursos

Por que as pessoas gostam tanto

Hybrid semantic search

Dense + BM25 vectors fused with Reciprocal Rank Fusion in one Qdrant round-trip — conceptual and exact-identifier search together.

AST-aware chunking

Files split at function/class boundaries via ast-grep, with incremental, batched and resumable indexing and live file watching.

Polyglot dependency graphs

Import/call graphs for 19+ languages with circular-dependency detection and Mermaid diagrams; symbol-level impact analysis.

Cross-project and branch-aware

Search linked projects in one query and keep separate indexes per git branch.

Private by default

Everything runs on your machine (Docker Qdrant + Ollama, no external calls); OpenAI/Gemini/Qdrant Cloud are optional.

Multi-agent friendly

Multiple agents share one index safely with cross-process locking and a single watcher per project.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/giancarloerra/SocratiCode.git
    cd SocratiCode
  2. Install as a host plugin/MCP server

    For VS Code-style hosts, register the server with npx; for Claude Code use the plugin — see the README Quick Start for your host.

    # VS Code / MCP hosts:
    # command: npx, args: -y --prefer-online socraticode@latest  # see README for your host's exact config
  3. Or build from source

    Clone, install and build, then register dist/index.js in your MCP host and restart it.

    git clone https://github.com/giancarloerra/SocratiCode.git
    cd SocratiCode
    npm install
    npm run build
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains SocratiCode?

It is maintained by giancarloerra on GitHub (giancarloerra/SocratiCode), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under AGPL-3.0; note the copyleft terms apply if you distribute modified versions or run it as a network service.

Does it need a paid API key?

No — the default local setup (Ollama + Qdrant in Docker) makes no external API calls; cloud embedding providers are optional and need their own keys.

How does it compare to built-in grep/semantic search inside an IDE or agent?

Compared with built-in grep/semantic search inside an IDE or agent, SocratiCode's distinguishing focus is: enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/giancarloerra/SocratiCode (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// 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

serena

An MCP toolkit that gives coding agents IDE-grade semantic retrieval, editing and refactoring

★ 30,1 mil estrelasGPL-3.0
Ver o guia →
Ferramentas de desenvolvimento

semble

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

★ 6,2 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

wigolo

Local-first web search, fetch, crawl and research for AI coding agents over MCP — no API keys.

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

fallow

Codebase intelligence for TypeScript/JavaScript — health, duplication, dead code and architecture.

★ 5,0 mil estrelasMIT
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 SocratiCode 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 SocratiCode: continue explorando dos dois lados dele.

Baixe o SocratiCode

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