Skip to content

v0.1.0 — first release

Choose a tag to compare

View all tags
@guimatheus92 guimatheus92 released this 27 Jun 01:17
v0.1.0
828c4ef
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First public release. Social Knowledge Base turns a creator's short videos into a searchable, markdown knowledge base — an LLM watches (frames + OCR) and listens (transcription) to each video and writes notes you can query. The app is bilingual (PT/EN).

What's in it

  • Download engine — gallery-dl (+ yt-dlp + ffmpeg) pulls every Reel, Story, and Highlight from a public Instagram profile, authenticated by browser cookies. Resumable via a download archive; ffmpeg is injected into PATH so audio is never dropped.
  • Bilingual Next.js 16 app — add multiple accounts, choose media types, hit Play, and watch live progress over SSE (counts, size, elapsed). Browse the collection through a global gallery and a per-account library with search, filters, and sort. Download a single video by link.
  • Reading pipeline — bulk transcription with faster-whisper (GPU/CUDA with automatic CPU fallback) writing .vtt/.txt/.json sidecars, plus the mcp-video-analyzer MCP for frames + OCR + timeline. Notes are generated one video at a time via Claude Code (any capable LLM; Claude Opus recommended), in a configurable language (default English).
  • Search (RAG) — the library is searchable from the transcription alone (ChromaDB), with a per-profile theme overview and citations back to the notes.
  • Per-account SQLite manifests (node:sqlite) as the source of truth — resumable, with no reprocessing of already-handled videos.
  • Runs anywhere via Docker — a single image bundling Node 24 + Python + gallery-dl + yt-dlp + ffmpeg; docker compose up and open http://localhost:3000.

Engineering foundation

  • CI (GitHub Actions), all required on main: lint, typecheck, unit tests (Vitest, 40 tests), production build, Playwright smoke e2e, a Docker image build, and a Python ruff check.
  • Strict lint (--max-warnings 0) with justified, documented exceptions.
  • Cross-platform stdout parsing (Windows \ and Linux /) so the engine behaves identically on the host and in the container.
  • Branch protection on main: the required checks must pass before merging; no force-pushes or branch deletion.
  • Governance: MIT license, Code of Conduct, Contributing guide, and a Security policy (cookies are treated as a credential and are never versioned).

See the README for setup and usage.

Assets 2
Loading