Setup GBrain và sử dụng thông qua Hermes agent

Chủ đề Second Brain dạo này được nhắc nhiều, về cơ bản là ý tưởng hay. Cách cài đặt cũng đa dạng. Bài viết này dùng GBrain kết hợp Hermes để tự động hoá việc học và compound.

Graph kiến thức của brain sau vài lần nạp sáng nay

Đầu tiên là cài Hermes agent theo hướng dẫn tại https://hermes-agent.nousresearch.com/docs/

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Quá trình thiết lập sẽ yêu cầu AI Provider, Message platform. Mình dùng Codex của OpenAI và Telegram.

Cứ bám theo hướng dẫn để tạo Telegram bot, rồi authen OpenAI account.

Cài đặt Gbrain

Step 1: Cài Bun

GBrain chạy trên Bun (runtime JavaScript nhanh). Chạy lệnh:

curl -fsSL https://bun.sh/install | bash
source ~/.bashrc
which bun  # lệnh này phải trả về ~/.bun/bin/bun

Step 2: Clone và cài đặt GBrain

git clone https://github.com/garrytan/gbrain ~/gbrain
cd ~/gbrain
bun install
bun link

Kiểm tra xem cài được chưa:

gbrain --version
# gbrain 0.22.x

Step 3: Fix lỗi PATH (quan trọng)

Do Hermes chạy agent dưới dạng ko tương tác nên lúc chạy sẽ ko có sẵn biến PATH có chứa path đến bun ~/.bun/bin) nên cần phải set thủ công vào .profile để được inject mỗi lần chạy. (Nếu ko có bun sẽ ko gọi được gbrain)

echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.profile
source ~/.profile

Step 4: Tạo repo chứa brain (vault)

Bạn chọn thư mục thích hợp. Ví dụ là ở home folder.

mkdir ~/brain
cd ~/brain
git init
git commit --allow-empty -m "init brain repo"

Step 5: Khởi tạo brain repo

gbrain init
# Sẽ mặc định dùng PGLite; ko cần config, ko cần server.

Step 6: Thiết lập cron tự động đồng bộ brain xuống DB định kỳ

Chạy crontab -e để add thủ công cho chắc.

PATH=$HOME/.bun/bin:/usr/local/bin:/usr/bin:/bin
*/5 * * * * $HOME/.bun/bin/gbrain sync --repo $HOME/brain >> $HOME/brain/sync.log 2>&1

Lưu ý trường hợp này thì brain đang ở $HOME nên sẽ là $HOME/brain, bạn cần chỉnh lại cho đúng với path của brain mình.

Sau đó check health của gbrain xem có issue gì ko, warning thôi thì là bình thường.

gbrain doctor

Đưa thông tin vào brain

gbrain sử dụng câu lệnh sau để nạp kiến thức vào:

gbrain put <slug> --content "<markdown content>" 

Tuy nhiên, chúng ta chỉ cần tương tác qua Telegram, Hermes sẽ lo phần làm việc với gbrain. Ngoài ra như trên thì gbrain nó sẽ nạp dữ liệu markdown, nên đối với các đầu vào như url bài viết, các thể loại file pdf, ảnh này nọ thì sẽ phải cần Hermes chuyển đổi sang markdown và nạp vào brain sẽ hợp lý hơn.

Flow như dưới:

Bạn bảo Hermes: “nạp bài viết này vào brain: [URL]”.
→ Hermes đọc skill ingest.
→ Hermes fetch và xử lý nội dung.
→ Hermes ghi file markdown vào ~/brain/.
→ Cron chạy mỗi 5 phút sẽ lấy dữ liệu đó.
→ GBrain lập chỉ mục (index) nó.

Đối với file thì nhắn Hermes như dưới:

Nạp file pdf này: [URL hoặc file path, đưa vào brain của tôi.

Khi Hermes có nhầm lẫn, hoặc để chắc chắn, thì nên hướng dẫn Hermes biết intent của bạn khi bạn nói kiểu nạp vào bộ nhớ hoặc nạp vào brain để nó build skills phân tích và nạp vào brain.

Một số tips khác

Prompt yêu cầu tạo skills (tham khảo)

create a skills when i ask you to ingest something, you can automatically read the input, convert them into md if needed, then use gbrain commands to store the knowledges into my personal brain at /Users/yennq/brain

Kiến trúc thư mục brain cá nhân

Vault/
├── Daily/                    # YYYY-MM-DD.md daily notes
├── System/
│   └── Assistant/
│       ├── context.md        # Operations overview
│       ├── preferences.md    # Communication style
│       └── environment.md    # Hardware, services, known issues
├── Work/
│   ├── Business-A/           # Workplace safety operations
│   └── Business-B/           # Cleaning services operations
├── Personal/
│   ├── Finance/              # Stock tracking, budgets
│   └── Health/               # Weight, sleep, Steps protocol
├── People/                   # Contacts map of content
└── Inbox/                    # Unclassified incoming

Prompt yêu cầu commit code và push sau mỗi lần nạp kiến thức

remember this: after ingesting to my brain vault, run git commit from the vault folder and push to origin.