> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/thiagofinch/mega-brain/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get from zero to your first insight in 5 minutes with Mega Brain

<Note>
  This guide assumes you've already completed the [installation](/installation) and setup wizard. If you haven't, run `npx mega-brain-ai setup` first.
</Note>

## Overview

Mega Brain transforms expert materials into structured knowledge through a 5-phase processing pipeline. In this guide, you'll:

1. Ingest your first material (video, PDF, or transcript)
2. Process it through the JARVIS pipeline
3. View the generated knowledge artifacts
4. Check your system status

<Warning>
  Make sure your `OPENAI_API_KEY` is configured in `.env` before proceeding. Video and audio ingestion requires OpenAI's Whisper API for transcription.
</Warning>

## Step 1: Ingest Your First Material

Mega Brain accepts any expert material - videos, PDFs, transcripts, podcasts, or training courses. Let's start with a YouTube video.

### Using Claude Code

Open your Mega Brain project in Claude Code and use the `/ingest` slash command:

<Steps>
  <Step title="Open Claude Code">
    Launch Claude Code and open your Mega Brain project directory.
  </Step>

  <Step title="Run the ingest command">
    In the Claude Code chat, type:

    ```
    /ingest https://www.youtube.com/watch?v=EXAMPLE_ID
    ```

    Replace `EXAMPLE_ID` with your actual YouTube video ID.
  </Step>

  <Step title="Review the output">
    JARVIS will download and process the transcription:

    ```
    JARVIS: Material received.

      Source:    YouTube
      Title:     "How to Create Irresistible Offers"
      Author:    Alex Hormozi
      Duration:  42:15
      Words:     6,230

      Saved in: inbox/alex-hormozi/how-to-create-irresistible-offers.md

      Next step: execute /process-jarvis to process.
    ```
  </Step>
</Steps>

### Alternative: Ingest Local Files

You can also ingest PDFs, Word documents, or text files:

<CodeGroup>
  ```bash YouTube Video theme={null}
  /ingest https://www.youtube.com/watch?v=dQw4w9WgXcQ
  ```

  ```bash Local PDF theme={null}
  /ingest /Users/you/Downloads/sales-playbook.pdf
  ```

  ```bash Local Transcript theme={null}
  /ingest /Users/you/Documents/expert-training.txt
  ```

  ```bash Google Drive (requires OAuth) theme={null}
  /ingest https://drive.google.com/file/d/YOUR_FILE_ID
  ```
</CodeGroup>

<Note>
  Materials are automatically organized by author in the `inbox/` directory. JARVIS extracts metadata like title, author, and date from the source.
</Note>

## Step 2: Process with JARVIS

Now that your material is ingested, run it through the 5-phase processing pipeline:

<Steps>
  <Step title="Launch the pipeline">
    In Claude Code, execute:

    ```
    /process-jarvis
    ```
  </Step>

  <Step title="Monitor the phases">
    JARVIS processes your material through 5 phases:

    ```
    JARVIS: Pipeline initiated.

      Phase 1/5 - Chunking .............. OK (23 chunks)
      Phase 2/5 - Resolution ............ OK (8 entities)
      Phase 3/5 - Extraction ............ OK (12 insights)
      Phase 4/5 - Synthesis ............. OK (3 narratives)
      Phase 5/5 - Compilation ........... OK

      Result:
        Dossier:   knowledge/dossiers/alex-hormozi.md
        Playbook:  knowledge/playbooks/irresistible-offers.md
        Insights:  12 new insights indexed

      Time total: 2m 34s
    ```
  </Step>

  <Step title="Understand the pipeline">
    Each phase transforms your content:

    | Phase           | Purpose                              | Output                  |
    | --------------- | ------------------------------------ | ----------------------- |
    | **Chunking**    | Break content into semantic segments | `artifacts/chunks/`     |
    | **Resolution**  | Identify people, concepts, entities  | `artifacts/insights/`   |
    | **Extraction**  | Extract frameworks and heuristics    | `artifacts/insights/`   |
    | **Synthesis**   | Consolidate narratives by theme      | `artifacts/narratives/` |
    | **Compilation** | Generate dossiers and playbooks      | `knowledge/`            |
  </Step>
</Steps>

## Step 3: Explore Your Knowledge Base

After processing, your knowledge base contains structured artifacts:

### View System Status

Check the health of your Mega Brain system:

```
/jarvis-briefing
```

Expected output:

```
JARVIS: Briefing Operacional

  Health Score: 92/100

  Knowledge Base:
    Experts:      1
    Dossiers:     1
    Playbooks:    1
    Insights:     12

  Last Processing:
    "How to Create Irresistible Offers" (Alex Hormozi)
    Processed on: 2026-03-06 14:30

  Active Agents:
    CRO .... Ready (12 insights loaded)
    CFO .... Ready (4 insights loaded)
    CMO .... Awaiting material
    COO .... Awaiting material

  Inbox pending: 0 files
```

<CardGroup cols={2}>
  <Card title="Dossiers" icon="user">
    Expert-focused compilations containing all knowledge from a specific person.

    **Location:** `knowledge/dossiers/persons/`
  </Card>

  <Card title="Playbooks" icon="book">
    Theme-based compilations organized by topic (sales, marketing, operations).

    **Location:** `knowledge/playbooks/`
  </Card>

  <Card title="DNA Schemas" icon="dna">
    5-layer cognitive models extracted from expert materials.

    **Location:** `knowledge/dna/`
  </Card>

  <Card title="Insights" icon="lightbulb">
    Individual extracted learnings with source traceability.

    **Location:** `artifacts/insights/`
  </Card>
</CardGroup>

## Step 4: Extract DNA (Optional)

For a deeper understanding of an expert's thinking, extract their cognitive DNA:

<Note>
  DNA extraction works best with 3-5+ materials from the same expert. With only one material, the DNA will be limited but still useful.
</Note>

```
/extract-dna alex-hormozi
```

Expected output:

```
JARVIS: DNA extraction initiated.

  Expert: Alex Hormozi
  Materials analyzed: 1

  Layer L1 - Philosophies .......... OK (5 beliefs extracted)
  Layer L2 - Mental Models ......... OK (3 frameworks)
  Layer L3 - Heuristics ............. OK (8 practical rules)
  Layer L4 - Frameworks ............. OK (2 methodologies)
  Layer L5 - Methodologies .......... OK (1 complete process)

  DNA saved in: knowledge/dna/alex-hormozi-dna.md
  Agent created: agents/persons/alex-hormozi.md

  Now you can consult:
    /ask alex-hormozi "How should I price my high-ticket offer?"
```

### The 5 DNA Layers

<Steps>
  <Step title="L1 - Philosophies">
    Core beliefs and worldview

    **Example:** "Value is created in the gap between cost and perceived benefit"
  </Step>

  <Step title="L2 - Mental Models">
    Thinking and decision frameworks

    **Example:** "The Value Equation (Dream Outcome + Perceived Likelihood - Time Delay - Effort & Sacrifice)"
  </Step>

  <Step title="L3 - Heuristics">
    Practical rules and decision shortcuts

    **Example:** "Always sell the result, not the mechanism"
  </Step>

  <Step title="L4 - Frameworks">
    Structured methodologies

    **Example:** "The Grand Slam Offer Framework"
  </Step>

  <Step title="L5 - Methodologies">
    Step-by-step implementations

    **Example:** "7-Step Offer Creation Process"
  </Step>
</Steps>

## Step 5: Query Your Knowledge

Once you have processed materials, you can query your knowledge base:

### Ask an Expert Agent

Query a mind-clone agent that thinks like the expert:

```
/ask alex-hormozi "How should I structure my offer to maximize perceived value?"
```

### Run a Conclave Session

Get multi-perspective analysis from your council of advisors:

```
/conclave "Should I launch my product at $2,997 or $4,997?"
```

Expected output:

```
CONCLAVE: Session initiated.

  Question: "Should I launch my product at $2,997 or $4,997?"

  ── METHODICAL CRITIC ──
  "Before deciding on price, we need to validate the Value Equation
  (Hormozi). What's the dream outcome, time delay, effort, and sacrifice
  of your product? Price should be a consequence of perceived value,
  not an arbitrary decision. If perceived value is 10x the price,
  both options work. If not, neither works."

  Sources: knowledge/playbooks/irresistible-offers.md

  ── DEVIL'S ADVOCATE ──
  "$4,997 seems attractive for margins, but consider: what's your
  current volume of qualified leads? If conversion drops from 8% to 4%
  at the higher price, you need double the leads. Can your funnel
  handle that? What's your current CAC? Risk: high ticket + weak
  funnel = zero revenue."

  Sources: CFO unit economics analysis

  ── SYNTHESIZER ──
  "Recommendation: Launch at $2,997 with an upgrade path to $4,997.
  This allows:
  1. Validate conversion at the lower price
  2. Create case studies with first customers
  3. Raise price with social proof
  Suggested timeline: 90 days at lower price, evaluate metrics, decide."

  Consensus: 2/3 recommend starting at $2,997
  Confidence: 78% (limited by 1-expert knowledge base)
```

## Common Workflows

### Batch Ingest Multiple Materials

Process multiple materials from the same expert:

```
/ingest https://www.youtube.com/watch?v=VIDEO_1
/ingest https://www.youtube.com/watch?v=VIDEO_2
/ingest /path/to/expert-book.pdf
/process-jarvis
```

### Build a Multi-Expert Knowledge Base

Diversify your knowledge with multiple experts:

```
/ingest https://www.youtube.com/watch?v=EXPERT_A_VIDEO
/ingest https://www.youtube.com/watch?v=EXPERT_B_VIDEO
/ingest https://www.youtube.com/watch?v=EXPERT_C_VIDEO
/process-jarvis
```

### Save and Resume Sessions

<CodeGroup>
  ```bash Save Current Session theme={null}
  /save
  ```

  ```bash Resume Previous Session theme={null}
  /resume
  ```
</CodeGroup>

## Troubleshooting

### Ingestion Failed

If `/ingest` fails:

1. **Check your OpenAI API key** in `.env`
2. **Verify the URL** is accessible
3. **Check the logs** in `logs/sessions/`

### Processing Stuck

If `/process-jarvis` hangs:

1. Check Claude Code is still responding
2. Review `logs/sessions/` for error messages
3. Try processing again with `/process-jarvis`

### No Insights Extracted

If the pipeline completes but extracts no insights:

1. **Check material quality** - ensure the content is substantive
2. **Review the source** in `inbox/` - verify it was transcribed correctly
3. **Try different material** - some sources work better than others

## Next Steps

<CardGroup cols={2}>
  <Card title="Configuration Guide" icon="gear" href="/configuration">
    Configure additional API keys for enhanced features like semantic search and voice interaction
  </Card>

  <Card title="Available Commands" icon="terminal" href="/commands/overview">
    Explore all available slash commands and CLI tools
  </Card>

  <Card title="DNA Schema Guide" icon="dna" href="/concepts/dna-schema">
    Deep dive into the 5-layer DNA extraction system
  </Card>

  <Card title="Agent System" icon="users" href="/concepts/agents">
    Learn about Cargo Agents (CRO, CFO, CMO, COO) and Mind Clones
  </Card>
</CardGroup>

<Note>
  **Pro Tip:** The more materials you ingest from the same expert, the richer your DNA extraction becomes. Aim for 3-5 materials per expert for optimal results.
</Note>