0e9702d494
- /podcasts — new page with PodcastPlayer (headphones icon) - /downloads — old media page renamed (download icon) - /media — kept for backward compat (same as downloads) - Nav: Reader → Podcasts → Downloads → Brain Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Second Brain Service
A "save everything" knowledge management backend. Captures links, notes, PDFs, images, and documents. AI classifies everything automatically. Supports keyword, semantic, and hybrid search.
Architecture
brain-api → FastAPI REST API (port 8200)
brain-worker → RQ background processor
brain-db → PostgreSQL 16 + pgvector
brain-redis → Redis 7 (job queue)
brain-meili → Meilisearch (keyword search)
brain-browserless → Headless Chrome (JS rendering + screenshots)
Quick Start
cd services/brain
# Copy and edit env
cp .env.example .env
# Add your OPENAI_API_KEY
# Start the stack
docker compose up -d
# Check health
curl http://localhost:8200/api/health
API Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/health |
Health check |
| GET | /api/config |
List folders/tags |
| POST | /api/items |
Create item (link/note) |
| POST | /api/items/upload |
Upload file |
| GET | /api/items |
List items (with filters) |
| GET | /api/items/{id} |
Get item by ID |
| PATCH | /api/items/{id} |
Update item |
| DELETE | /api/items/{id} |
Delete item |
| POST | /api/items/{id}/reprocess |
Re-run AI classification |
| POST | /api/search |
Keyword search (Meilisearch) |
| POST | /api/search/semantic |
Semantic search (pgvector) |
| POST | /api/search/hybrid |
Combined keyword + semantic |
Gateway Integration
The platform gateway proxies /api/brain/* to brain-api:8200/api/*.
Auth is handled by the gateway injecting X-Gateway-User-Id header.
The brain-api container joins the pangolin Docker network so the gateway can reach it.
Processing Flow
- User submits URL/note/file → stored immediately as
pending - RQ worker picks it up → status becomes
processing - Worker: fetches content, takes screenshot, extracts text
- Worker: calls OpenAI for classification (folder, tags, title, summary)
- Worker: generates embedding via OpenAI
- Worker: indexes in Meilisearch
- Status becomes
ready(orfailedon error)
Storage
Files stored locally at ./storage/. Each item gets a subdirectory:
storage/{item_id}/screenshot/screenshot.png
storage/{item_id}/archived_html/page.html
storage/{item_id}/original_upload/filename.pdf
S3-compatible storage can be added by implementing S3Storage in app/services/storage.py.