whatisgithub

What is bhd?

hanghang-614/bhd — explained in plain English

Analysis updated 2026-05-18

31PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A local personal memory and knowledge base system that stores notes and AI coding session transcripts, then makes them searchable through search and Qdrant vector similarity.

Mindmap

mindmap
  root((BHD Memory))
    Ingestion
      Transcript Scanning
      Document Upload
      Background Queue
    Storage
      SQLite Facts
      Qdrant Vectors
      Graph Layer
    Governance
      Memory States
      Review Queue
      Access Logs
    Interfaces
      REST API
      Web UI
      CLI Tool

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically extract and archive long-term memories from Claude Code or Codex conversation transcripts.

USE CASE 2

Upload documents like PDFs, Word files, or spreadsheets and have them chunked and stored for later search.

USE CASE 3

Search past notes and memories using both structured facts and vector similarity search combined.

USE CASE 4

Route low-confidence or sensitive memories into a review queue before they become active.

What is it built with?

PythonSQLiteQdrantReactVite

How does it compare?

hanghang-614/bhdcoleam00/harness-engineering-democolor4-alt/citecheck
Stars313131
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity4/53/52/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a local Qdrant instance running before starting the service.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

BHD Memory is a personal memory and knowledge base system that runs locally. Its main purpose is to store things you want to remember across AI coding sessions, documents, and notes, and then let you retrieve them later through search or by hooking into tools like Claude Code and Codex. The system has two main ways to add content. The first is scanning conversation transcripts from AI coding tools (Claude Code, Codex, or JSONL files), archiving those sessions, and automatically extracting memories that seem worth keeping long-term. The second is uploading documents directly: plain text, URLs, Markdown files, HTML, PDF, Word documents, PowerPoint files, and spreadsheets are all supported. Uploaded content is parsed and broken into chunks for storage. Storage uses two databases working together. SQLite holds the structured facts, evidence records, and a log of changes. Qdrant (a vector search engine that runs on your own machine) holds numeric representations of the content for similarity-based search. When you search, the system queries both and combines the results. Memories can be in different states: active, pending review, paused, archived, or deleted. Low-confidence items, sensitive information, and conflicting memories go into a review queue for manual inspection before they become active. The system exposes a REST API and includes a web management interface built with React and Vite, accessible at localhost:8767. There is also a command-line tool for uploading content, writing memories, and querying the system directly. Background ingestion jobs run through a queue backed by SQLite, so large uploads process asynchronously without blocking the interface. A graph layer tracks entities, relationships between them, and how those relationships change over time, which is compatible with the Graphiti graph memory format. The README is written in Chinese.

Copy-paste prompts

Prompt 1
Explain how to combine a SQLite database for structured facts with a Qdrant vector database for similarity search in one retrieval system.
Prompt 2
Show me how to build a background job queue backed by SQLite so large document uploads process asynchronously.
Prompt 3
How do I parse a conversation transcript from a coding assistant and automatically extract facts worth remembering long-term?
Prompt 4
Explain a review queue pattern where low-confidence or conflicting records require manual approval before becoming active.
Prompt 5
Show me how to build a knowledge graph layer in SQLite that tracks entities, relationships, and how they change over time.

Frequently asked questions

What is bhd?

A local personal memory and knowledge base system that stores notes and AI coding session transcripts, then makes them searchable through search and Qdrant vector similarity.

What language is bhd written in?

Mainly Python. The stack also includes Python, SQLite, Qdrant.

What license does bhd use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is bhd to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is bhd for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.