second-brain-gateway

Local-first HTTP gateway for second-brain memory storage and retrieval.

Features

• Text memory capture and retrieval over REST.
• Server-side project/tag filtering in recall/recent APIs.
• Project index endpoint (/api/projects).
• Secret-pattern guard in POST /api/remember with explicit override (force=true).

Endpoints

• GET /health
• GET /
• POST /api/remember
• POST /api/recall
• GET /api/recent
• GET /api/projects
• POST /api/forget

Quick Start

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env
.venv/bin/uvicorn app:app --host 0.0.0.0 --port 8088

Environment

• DB_HOST
• DB_PORT
• DB_NAME
• DB_USER
• DB_PASSWORD
• BRAIN_HOST (for systemd service command expansion)
• BRAIN_PORT (for systemd service command expansion)

Systemd

An example user service file is included at:

• deploy/systemd/second-brain-gateway.service

Security Notes

• Keep this gateway on intranet/VPN unless you add auth and TLS at a reverse proxy.
• Secret-pattern blocking is best-effort and intentionally conservative.