Repolode
Submit
imraywang

imraywang/rays-brain-kit

A local, Markdown-based personal knowledge system combining an Obsidian vault template, an AI capture pipeline, and a Python stdlib review dashboard.

Open-source alternative to:Notion

View on GitHub
Stars
79
Forks
18
Open issues
0
Last commit
10 days ago

What is it?

Ray's Brain Kit is a personal knowledge system that runs on your own computer. It bundles an Obsidian vault folder structure, an AI capture pipeline that gathers and distills source material into review cards, and a local dashboard for deciding what to keep, what to write, and what to publish. All data is stored as plain Markdown files, so the vault stays editable in Obsidian without a separate database.

The three components can be used independently. The dashboard runs on Python 3 standard library only and serves a local page at 127.0.0.1 with a review queue, an eight-column progress board, full-text search, and quick idea capture. The capture pipeline optionally uses Codex CLI for distillation, xurl for X bookmarks, and an iCloud drop folder for mobile sharing. An optional viral-topic radar uses the TikHub API.

The design centers on AI doing extraction and scoring while the user makes the final decisions. Review and candidate items have a seven-day attention window, after which they leave the active queue while source material is kept.

Key features

  • 01Generates a Obsidian vault skeleton with demo data via a bootstrap script.
  • 02Local dashboard with review queue, keyboard shortcuts, and an eight-stage progress board.
  • 03Stores everything as Markdown files with no database.
  • 04Optional AI pipeline turns new material into review cards using Codex CLI.
  • 05Collects web clippings, X bookmarks, and phone shares into the vault.
  • 06Binds to localhost by default and can be installed as a browser app.

Use cases

  • Building a personal knowledge base in Obsidian that stays fully local.
  • Turning saved articles and bookmarks into reviewed notes and writing topics.
  • Running a content workflow from idea to draft to publishing feedback.
  • Adding a lightweight Python dashboard on top of an existing Markdown vault.

Quick start

  1. 1

    Clone the repository and enter the folder

    git clone https://github.com/imraywang/rays-brain-kit.git my-brain && cd my-brain
  2. 2

    Generate the folder skeleton with demo data

    python3 50-系统/40-自动化/知识仪表盘/bootstrap.py . --demo
  3. 3

    Start the local dashboard server

    python3 50-系统/40-自动化/知识仪表盘/server.py
  4. 4

    Open http://127.0.0.1:8765 in your browser, or open the folder in Obsidian

Things to know

  • The AI capture pipeline needs the Codex CLI, and X capture needs xurl with OAuth.
  • The optional viral topic radar requires a TikHub API key and is billed per request.
  • Scheduled runs are set up with launchd, which is macOS-specific.
  • Folder names, documentation and templates are primarily in Chinese.

In collections

Privacy & local-first toolsStatic site generators & documentation tools

Topics

#personal-knowledge-management#obsidian#markdown#local-first#python#knowledge-base#content-workflow

FAQ

What is rays-brain-kit?
A local, Markdown-based personal knowledge system combining an Obsidian vault template, an AI capture pipeline, and a Python stdlib review dashboard. Ray's Brain Kit is a personal knowledge system that runs on your own computer. It bundles an Obsidian vault folder structure, an AI capture pipeline that gathers and distills source material into review cards, and a local dashboard for deciding what to keep, what to write, and what to publish. All data is stored as plain Markdown files, so the vault stays editable in Obsidian without a separate database.
Is rays-brain-kit free to use? What license does it have?
rays-brain-kit is open source under the MIT license. Check the license terms before using it in commercial products.
Is rays-brain-kit still maintained?
Actively maintained. The last commit to rays-brain-kit was on Oct 28, 2026.
What can I use rays-brain-kit for?
Building a personal knowledge base in Obsidian that stays fully local. Turning saved articles and bookmarks into reviewed notes and writing topics. Running a content workflow from idea to draft to publishing feedback. Adding a lightweight Python dashboard on top of an existing Markdown vault.
How do I install rays-brain-kit?
Clone the repository and enter the folder: git clone https://github.com/imraywang/rays-brain-kit.git my-brain && cd my-brain Generate the folder skeleton with demo data: python3 50-系统/40-自动化/知识仪表盘/bootstrap.py . --demo Start the local dashboard server: python3 50-系统/40-自动化/知识仪表盘/server.py Open http://127.0.0.1:8765 in your browser, or open the folder in Obsidian
Where can I get rays-brain-kit?
The source code and installation instructions are on GitHub: https://github.com/imraywang/rays-brain-kit

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects