explaingit

thiagofinch/mega-brain

Analysis updated 2026-05-18

73PythonAudience · pm founderComplexity · 3/5Setup · hard

TLDR

A local-first knowledge system for Claude Code that turns your videos, PDFs, and notes into a searchable AI brain and a multi-agent panel that debates decisions using only your own material.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

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

Feed your own videos, PDFs, and transcripts into a searchable knowledge base with cited answers.

USE CASE 2

Ask a multi-agent panel to debate a strategic decision grounded only in material you provided.

USE CASE 3

Build a private, local knowledge base without relying on an external database.

USE CASE 4

Extract recurring frameworks and mental models from expert content you have collected.

What is it built with?

PythonNode.jsClaude CodeRAG

How does it compare?

thiagofinch/mega-braindcdmllm/instructsamgmboquet/mixle
Stars737373
LanguagePythonPythonPython
Setup difficultyhardhardmoderate
Complexity3/54/54/5
Audiencepm founderresearcherresearcher

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Claude Code, Node.js, Python, and multiple external API keys (Anthropic, OpenAI, and Gemini for video) before it can be used.

The README does not state a license, the project is distributed as a private, invite-only repository.

In plain English

Mega Brain is a knowledge management system that turns raw material you own, such as videos, PDFs, and transcripts, into something an AI can reason with and cite. It runs inside Claude Code, Anthropic's command line coding assistant, using custom commands like ingest, process jarvis, conclave, and jarvis briefing. Everything is local first, meaning your material stays on your own computer's filesystem rather than living in someone else's database. The system works in three layers. First, an ingestion pipeline takes whatever you feed it, transcribes it if needed, breaks it into pieces, and pulls out what the project calls the cognitive DNA: things like the source's philosophies, mental models, heuristics, frameworks, values, and recurring patterns. Second, that extracted knowledge is indexed for hybrid search, meaning you can search by meaning as well as by keyword, and every answer points back to where it came from. Third, and described as the standout feature, is the Conclave: a panel of AI agents, including a methodological critic, a devil's advocate, and a synthesizer, that debate a strategic question you ask using only the knowledge you fed into the system, and nothing else. Setting it up requires Claude Code itself, Node.js 18 or newer, Python 3.10 or newer, and Git, plus API keys from external AI providers. An Anthropic key powers the core reasoning, an OpenAI key handles audio transcription and search embeddings, and a Gemini or Google key is needed if you want to ingest video. Optional keys add voice output, speech to text, and speaker-labeled transcription. The project is distributed as a private, invite only repository, and your API keys are kept in a local file that is never committed to the repository. This tool is built for people who want an AI assistant grounded strictly in material they trust, rather than one that answers from general internet knowledge, useful for founders, consultants, or researchers making decisions based on a specific body of expert content they have collected.

Copy-paste prompts

Prompt 1
Walk me through setting up Mega Brain inside Claude Code, including the required API keys.
Prompt 2
Explain what the /ingest and /process-jarvis commands do and how they work together.
Prompt 3
Describe how the Conclave's three agent roles debate a question differently from each other.
Prompt 4
Help me plan what source material to ingest first for a founder decision-making knowledge base.
Prompt 5
Compare Mega Brain's local-first RAG approach to a cloud-hosted knowledge base tool.

Frequently asked questions

What is mega-brain?

A local-first knowledge system for Claude Code that turns your videos, PDFs, and notes into a searchable AI brain and a multi-agent panel that debates decisions using only your own material.

What language is mega-brain written in?

Mainly Python. The stack also includes Python, Node.js, Claude Code.

What license does mega-brain use?

The README does not state a license, the project is distributed as a private, invite-only repository.

How hard is mega-brain to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is mega-brain for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.