second-brain/README.md
Travis Herbranson 250ca9fd2f project init
2026-05-22 19:08:22 -04:00

51 lines
1.3 KiB
Markdown

# second-brain
A personal knowledge system built on a video/article extraction pipeline and an LLM-maintained wiki (inspired by the Karpathy LLM Wiki pattern).
## What it does
1. **Pull** — download YouTube videos or fetch web articles
2. **Transcribe** — extract transcripts via Whisper (videos) or trafilatura (articles)
3. **Extract** — single-shot Claude call produces structured notes per source
4. **Review** — web UI to accept or reject extractions
5. **Compile** — wiki compiler folds accepted extractions into a living Obsidian vault
## Quick start
```bash
# Install dependencies
uv sync
# Copy and edit config
cp config/settings.toml config/settings.local.toml
# Queue a source
uv run second-brain add https://www.youtube.com/watch?v=...
# Run the pipeline
uv run second-brain process
# Review in the web UI
uv run second-brain serve
# Compile to wiki
uv run second-brain compile
```
## Domains
Extractions are tagged by domain so the right prompt template is used:
| Domain | Focus |
|--------|-------|
| `development` | Software, programming, systems |
| `content` | Content creation, video production |
| `business` | Entrepreneurship, marketing, ops |
| `homelab` | Self-hosted infra, networking, DevOps |
## Requirements
- Python 3.12+
- `ANTHROPIC_API_KEY` environment variable
- ffmpeg (for Whisper audio extraction)