{"data":{"slug":"giancarloerra-socraticode","name":"SocratiCode","tagline":"Enterprise-grade codebase intelligence with local setup, hybrid semantic search, and polyglot dependency graphs","github_url":"https://github.com/giancarloerra/SocratiCode","owner":"giancarloerra","repo":"SocratiCode","owner_avatar_url":"https://avatars.githubusercontent.com/u/105157948?v=4","primary_language":"TypeScript","stars":3313,"forks":423,"topics":["ai","ai-assistant","ast","claude","claude-code","code-graph","codebase-intelligence","context-engine","docker","embeddings","gemini","gemini-cli-extension","mcp","openai","qdrant","semantic","semantic-search","vector-database","vector-embeddings","vector-search"],"archived":false,"github_pushed_at":"2026-09-17T19:14:39+00:00","maintenance_label":"Very active","stars_delta_30d":181,"url":"https://www.graphcanon.com/tools/giancarloerra-socraticode","markdown_url":"https://www.graphcanon.com/tools/giancarloerra-socraticode.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/giancarloerra-socraticode","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=giancarloerra-socraticode","description":"Enterprise-grade (40m+ LOC) codebase intelligence, zero-setup, local & private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis & call-flow, interactive HTML viewer, cross-project & branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.","homepage_url":"https://socraticode.cloud","license":"AGPL-3.0","open_issues":2,"watchers":18,"ai_summary":"SocratiCode offers advanced capabilities for code analysis including symbol-level impact analysis, cross-project and branch-aware search. Integrates with various AI frameworks like Claude and Gemini.","readme_excerpt":"## Quick Start\n\n> **Requirements:** [Node.js 18.17 or newer](https://nodejs.org/) with `npx` on `PATH`, plus [Docker](https://www.docker.com/products/docker-desktop/) running for the default local Qdrant and Ollama stack.\n\n**Quick install guidance for Claude Code, VS Code, and Cursor:**\n\n\n  \n\n**MCP hosts with a JSON `mcpServers` object** can use this complete configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"socraticode\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"--prefer-online\", \"socraticode@latest\"]\n    }\n  }\n}\n```\n\nConfiguration schemas are host-specific. Continue, VS Code, Zed, OpenCode, Gemini CLI, Cline, and Roo Code have dedicated examples in [Plugins and host integrations](#plugins-and-host-integrations).\n\n---\n\n### Install\n\nUse the host-specific steps in [Plugins and host integrations](#plugins-and-host-integrations). They cover installation scope, activation, verification, updates, and each host's actual configuration schema.\n\n#### From source (for contributors)\n\n```bash\ngit clone https://github.com/giancarloerra/socraticode.git\ncd socraticode\nnpm install\nnpm run build\n```\n\nRegister `node /absolute/path/to/socraticode/dist/index.js` in the user or project scope supported by your MCP host, then restart the server or start a new session. Verify SocratiCode in the host's MCP server list. To update, run `git pull --ff-only`, `npm install`, and `npm run build` in the clone, then restart the MCP server and verify it again.\n\n---\n\n## Docker Resources\n\nSocratiCode manages Docker containers and persistent volumes:\n\n| Resource | Name | Purpose | When |\n|----------|------|---------|------|\n| Container | `socraticode-qdrant` | Qdrant vector database (pinned `v1.17.0`) | `managed` mode only |\n| Container | `socraticode-ollama` | Ollama embedding server | `docker` mode only |\n| Volume | `socraticode_qdrant_data` | Persistent vector storage | `managed` mode only |\n| Volume | `socraticode_ollama_data` | Persistent model storage | `docker` mode only |\n\nIn `QDRANT_MODE=external` mode, the Qdrant container and volume are not created or started — SocratiCode connects directly to the configured remote endpoint. Server-side BM25 inference (used for hybrid search) requires **Qdrant v1.15.2 or later**. The managed container runs `v1.17.0`. If you bring your own Qdrant instance, ensure it meets this minimum.\n\nAll containers use `--restart unless-stopped` for automatic recovery.\n\n> **Why non-standard ports?** SocratiCode intentionally uses non-default ports for its managed containers — `16333`/`16334` instead of Qdrant's defaults (`6333`/`6334`), and `11435` instead of Ollama's default (`11434`). This avoids conflicts with any Qdrant or Ollama instance you may already be running locally. All ports are overridable via environment variables if needed.\n\n---\n\n# Run only unit tests (no Docker needed)\nnpm run test:unit\n\n---\n\n# Run integration tests (requires Docker)\nnpm run test:integration\n\n---\n\n# Run end-to-end tests (requires Docker)\nnpm run test:e2e\n\n---\n\n## License\n\nSocratiCode is dual-licensed:\n\n- **Open Source** — [AGPL-3.0](LICENSE). Free to use, modify, and distribute.\n  If you modify SocratiCode and offer it as a network service, you must release\n  your modifications under AGPL-3.0.\n\n- **Commercial** — For organisations that need to use SocratiCode in proprietary\n  products or services without AGPL obligations. See [LICENSE-COMMERCIAL](LICENSE-COMMERCIAL)\n  or contact [giancarlo@altaire.com](mailto:giancarlo@altaire.com).\n\nCopyright (C) 2026 Giancarlo Erra - Altaire Limited.","github_created_at":"2026-02-26T16:12:26+00:00","created_at":"2026-07-07T17:43:59.695664+00:00","updated_at":"2026-09-20T06:01:16.75356+00:00","categories":[{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"},{"slug":"vector-databases","name":"Vector Databases","url":"https://www.graphcanon.com/categories/vector-databases","markdown_url":"https://www.graphcanon.com/categories/vector-databases.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/vector-databases"}],"tags":[{"slug":"ai-assistant","name":"ai-assistant"},{"slug":"ast","name":"ast"},{"slug":"claude-code","name":"claude-code"},{"slug":"code-graph","name":"code-graph"},{"slug":"context-engine","name":"context-engine"},{"slug":"embeddings","name":"embeddings"},{"slug":"gemini-cli-extension","name":"gemini-cli-extension"},{"slug":"mcp","name":"mcp"}],"trust":{"provenance":{"is_fork":false,"github_id":1167732163,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T06:01:14.551Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":12,"days_since_push":2,"last_release_at":"2026-09-16T14:26:47Z","stars_delta_30d":181,"open_issues_delta_30d":2},"security_summary":{"status":"no_manifest","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:24:47.909Z","medium_count":0,"scan_profile":"mcp_manifest","critical_count":0}},"capability_facts":{"mcp":{"source":"package.json:@modelcontextprotocol/*","observed_at":"2026-09-20T06:01:15.602Z","server_manifest":true},"scan":{"source":"repo_scan","observed_at":"2026-09-20T06:01:15.602Z"},"deploy":{"source":"dockerfile:docker-compose.yml","self_host":true,"observed_at":"2026-09-20T06:01:15.602Z","managed_saas":false},"has_cli":{"value":true,"source":"package.json:bin|scripts","observed_at":"2026-09-20T06:01:15.602Z"},"languages":{"value":["typescript","javascript"],"source":"github.language+package.json","observed_at":"2026-09-20T06:01:15.602Z"},"has_docker":{"value":true,"source":"dockerfile:docker-compose.yml","observed_at":"2026-09-20T06:01:15.602Z"},"license_spdx":{"value":"AGPL-3.0","source":"github.license","observed_at":"2026-09-20T06:01:15.602Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["- When working with extremely large codebases (>40 million lines of code), as SocratiCode supports such scale efficiently.","- For teams that prioritize local and private setups over cloud-based services, ensuring data privacy and compliance.","- In scenarios where zero-setup deployments are preferred for quick integration into existing environments.","- When integrating with AI frameworks like Claude or Gemini is desired to enhance development workflows."],"when_not_to_use":["- If your project scale is small (<1 million lines of code), you may find SocratiCode's capabilities overkill and more complex than necessary.","- For organizations that do not require local setup and can leverage cloud-based solutions, as using SocratiCode might offer redundant features."],"source":"enrich:decision_facts","observed_at":"2026-07-12T11:28:42.146Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"SocratiCode is an advanced code intelligence tool tailored for large-scale enterprise projects."}]}}