Skip to content

Credits

triforge stands on the shoulders of three brilliant open-source projects. All credit for the algorithms, models, and code of the components belongs to their authors — triforge is the integration layer.

semble — Code search for AI agents

Used as: an MCP server registered globally and invoked on demand by Claude Code. We do not bundle semble; triforge install writes a uvx --from "semble[mcp]" semble entry into ~/.claude.json. We also use MinishLab's model2vec library directly (the potion-base-8M static-embedding model) for our chat-memory dense vectors.

InsForge — Backend-as-a-Service for AI agents

Used as: the default insforge MCP server URL (cloud https://mcp.insforge.dev/mcp) registered globally by triforge install. Self-hosted InsForge (Docker Compose) is also the recommended target for triforge migrate --to=insforge, because it ships PostgreSQL + pgvector preconfigured.

HippoRAG 2 — Neurobiologically-inspired GraphRAG

The triforge-memory layer is inspired by HippoRAG 2 — same idea of LLM-driven OpenIE, NetworkX knowledge graph, and Personalized PageRank retrieval. We do not depend on the upstream hipporag package because it has heavy ML dependencies that don't yet support Python 3.13+. Instead, triforge ships its own lightweight implementation in memory/openie.py and memory/graph.py that follows HippoRAG's design with a pure-Python PPR fallback.

Inspiration

The decision to use a HippoRAG-style approach for chat memory (rather than vanilla cosine RAG) was inspired by an article on Habr:

The article walks through HippoRAG 2 and convinced us that for "remember what we discussed three sessions ago" workloads, a small KG + PPR beats a flat vector store by a wide margin in token efficiency.

Other open source

  • mcp — Anthropic's MCP server SDK (FastMCP)
  • bm25s — pure-Python BM25, way faster than rank-bm25
  • vicinity — vector store backend (also from MinishLab)
  • networkx — graph algorithms
  • pyarrow — parquet shards
  • portalocker — cross-platform file locks
  • typer + rich — CLI

License of triforge itself

Apache-2.0 — see NOTICE for the full third-party attribution required by the license.