Swarmauri Vectorstore Git

A Swarmauri community vector store that indexes Git repositories for semantic retrieval over commits and git log style records.

Features

• Index scopes:
  • head: commits reachable from HEAD
  • ref: commits reachable from a specific branch, tag, or revision
  • all_refs: commits reachable from every ref in the repository
• Document kinds:
  • commit: normalized commit metadata and changed-path text
  • log: rendered git log --stat style text
• Pure git CLI backend, so there is no hard dependency on pygit2
• Convenience CLI with colored logs for ad hoc retrieval
• Default CLI behavior targets the current repo (.) and indexes all refs via --ref all

Installation

pip install swarmauri_vectorstore_git

Usage

from swarmauri_standard.documents.Document import Document
from swarmauri_vectorstore_git import GitVectorStore

store = GitVectorStore(
    repo_path=".",
    scope="all_refs",
    document_kinds=("commit", "log"),
)

store.build_index()
results = store.retrieve("oauth token bug", top_k=3)

for document in results:
    print(document.metadata["oid"], document.metadata["kind"])
    print(document.content[:200])

CLI

gitvs query --query "memory leak fix" --top-k 5

To inspect a specific retrieved document:

gitvs show --ref feature/my-branch --document-id <document-id>

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing.