Highlights

• Product: HerPeakGem / 他山之石
• Domain: 智能教育
• Maintained by: 503496348-ops product matrix
• Delivery posture: one-click setup, doctor diagnostics, smoke test, convergence gate, and clean-clone verification are part of the maintenance standard.

Quality Gates

./install.sh
python3 scripts/doctor.py
python3 scripts/smoke.py
python3 scripts/product_convergence_gate.py --json
python3 -m pytest tests/ -q

一键安装 / One-click Quickstart

bash install.sh
python3 scripts/doctor.py
python3 scripts/smoke.py

• bash install.sh：自动执行 setup + smoke，适合第一次使用。
• python3 scripts/doctor.py：检查环境、入口文件和产品门禁，失败时给出修复建议。
• python3 scripts/smoke.py：执行产品收敛门禁和轻量核心冒烟验证。

 

他山之石 · HerPeakGem: Agent-Native Personalized Tutoring

 

Features · Get Started · Explore · CLI · Ecosystem · Community

---

🤝 We welcome contributions! See our Contributing Guide for branching strategy, coding standards, and how to get started.

📦 Releases

[2026.6.18] v1.4.8 — Connect your own Partners under My Agents and consult them live in chat (their persona, library and skills answer through their own loop), and every Partner gains a private memory via partner_read / partner_memorize / partner_search.

[2026.6.17] v1.4.7 — Connect your local Claude Code / Codex and consult it live mid-turn, My Agents graduates to a top-level /agents, and Partner conversations gain branch / resume / delete with a replayable trace.

[2026.6.14] v1.4.6 — Four-surface consolidation: a Knowledge Center with GraphRAG / PageIndex / LightRAG engines and linked-KB / Obsidian mounts, a Space learning dashboard with My Agents and top-level Memory, plus document parsing / voice / media settings.

[2026.6.13] v1.4.5 — Guided Learning rebuilt on the chat agent loop with a hard per-type mastery gate and a /learning dashboard, a new loop-plugin framework, plus Markdown export for Partner conversations.

[2026.6.12] v1.4.4 — Install community skills from ClawHub with herpeakgem skill install behind a security gate, plus real in-browser DOCX/XLSX previews for knowledge-base files.

[2026.6.12] v1.4.3 — TutorBot becomes Partners on a production-grade IM pipeline (15 channels, live streaming), Chat moves to a single agent loop, real per-user isolation, and a rebuilt Visualize.

📰 News

• 2026-05-22 🌐 Official docs site live at herpeakgem.info — guides, references, and capability tours in one place.
• 2026-04-10 📄 Our paper is live on arXiv — read the preprint for the design and ideas behind HerPeakGem.

✨ Key Features / 核心特性

HerPeakGem is an agent-native learning workspace that connects tutoring, problem solving, quiz generation, research, visualization, and mastery practice in one extensible system.

他山之石（HerPeakGem）是一个 Agent 原生的智能学习工作台，将辅导、解题、出题、研究、可视化和掌握练习整合在一个可扩展的系统中。

• One runtime for every mode — Chat, Solve, Quiz, Research, Visualize, and Mastery Path share the same tutoring engine, so context can move with the learner. 统一运行时 — 聊天、解题、出题、研究、可视化和学习路径共享同一个教学引擎，上下文随学习者流动。
• Connected learning context — Knowledge Bases, books, Co-Writer drafts, Space assets, notebooks, and Memory stay available across workflows instead of living in isolated tools. 连通的学习上下文 — 知识库、书籍、协作文档、空间资产、笔记本和记忆跨工作流可用，不再孤立。
• Extensible tools and skills — Built-in tools, MCP tools, built-in skills, and installable community skills let HerPeakGem grow with new learning workflows. 可扩展的工具和技能 — 内置工具、MCP 工具、内置技能和可安装的社区技能让 HerPeakGem 持续成长。
• Inspectable memory — L1 traces, L2 surface summaries, and L3 synthesis make personalization visible, editable, and grounded in prior activity. 可检查的记忆 — L1 追踪、L2 表面摘要和 L3 综合让个性化可见、可编辑、有据可依。
• Persistent Partners — IM-connected companions run on the same agent loop, each with its own soul, channels, workspace, and assigned library. 持久的伙伴 — IM 连接的学习伙伴运行在同一个 Agent 循环上，各自拥有独立的人格、频道、工作区和知识库。

---

🚀 Get Started / 快速开始

HerPeakGem ships four installation paths. They all share one workspace layout: settings live in data/user/settings/ under the directory you launch from (or under HERPEAKGEM_HOME / herpeakgem start --home if you set one explicitly). For the full app, the recommended flow is pick a workspace directory → install → herpeakgem init → herpeakgem start.

Option 1 — Install From PyPI / 从 PyPI 安装

mkdir -p my-herpeakgem && cd my-herpeakgem
pip install -U herpeakgem
herpeakgem init     # prompts for ports + LLM provider + optional embedding
herpeakgem start    # starts backend + frontend; keep the terminal open

After herpeakgem start, open the frontend URL printed in the terminal.

Option 2 — Install From Source / 从源码安装

git clone https://github.com/503496348-ops/herpeakgem.git
cd HerPeakGem

python3 -m venv .venv && source .venv/bin/activate
python -m pip install --upgrade pip

python -m pip install -e .
( cd web && npm ci --legacy-peer-deps )

herpeakgem init
herpeakgem start

Option 3 — Docker

docker run --rm --name herpeakgem \
  -p 127.0.0.1:3782:3782 \
  -p 127.0.0.1:8001:8001 \
  -v herpeakgem-data:/app/data \
  ghcr.io/atomcollide/herpeakgem:latest

Option 4 — CLI Only / 仅 CLI

git clone https://github.com/503496348-ops/herpeakgem.git
cd HerPeakGem

python3 -m venv .venv-cli && source .venv-cli/bin/activate
python -m pip install --upgrade pip

python -m pip install -e ./packaging/herpeakgem-cli
herpeakgem init --cli
herpeakgem chat

📖 Explore HerPeakGem / 探索他山之石

Start with the main surfaces you will use day to day: Chat, Partners, Co-Writer, Book, Knowledge, Space, Memory, and Settings.

💬 Chat — The Agent Loop / 聊天 — Agent 循环

Chat is the default capability and the place where most work begins. A single thread can talk normally, call tools, ground itself in selected knowledge bases, read attachments, write notebook records, and continue with the same source inventory across turns.

🤝 Partner — Persistent Companions / 伙伴 — 持久的学习伴侣

Partners replace the older TutorBot engine with a cleaner model: every inbound web or IM message becomes a normal ChatOrchestrator turn inside a partner-scoped workspace.

✍️ Co-Writer — Markdown Drafting / 协作写作 — Markdown 草稿

Co-Writer is a split-view Markdown workspace for reports, tutorials, notes, and long-form learning artifacts.

📖 Book — Living Books / 书籍 — 活的教材

   

Book turns selected sources into interactive learning material.

📚 Knowledge — Versioned RAG Libraries / 知识库 — 版本化 RAG 库

Knowledge Bases are the document collections behind RAG. The current stack is LlamaIndex-only, with a flat version-N storage layout keyed by embedding signature.

🏗️ HerPeakGem CLI — Agent-Native Interface

herpeakgem chat                                          # Interactive REPL
herpeakgem chat --capability deep_solve --tool rag --kb my-kb
herpeakgem run chat "Explain Fourier transform"
herpeakgem run deep_solve "Solve x^2 = 4" --tool rag --kb my-kb
herpeakgem kb create my-kb --doc textbook.pdf
herpeakgem memory show
herpeakgem config show
herpeakgem provider login openai-codex      # OAuth login
herpeakgem provider login github-copilot    # Validate existing GitHub Copilot auth

Provider auth (openai-codex OAuth login; github-copilot validates an existing Copilot auth session)

See SKILL.md for the full CLI reference.

🌐 Ecosystem — Open to the Skills Community

HerPeakGem supports installable community skills from ClawHub:

herpeakgem skill search "flashcards"
herpeakgem skill install clawhub:flashcards

👥 Community

• Discord
• Contributing Guide

📄 License

Apache-2.0 — see LICENSE for details.

📖 Citation / 引用

If you use this software, please cite it as below / 如果使用本软件，请按以下格式引用：

@article{zhao2026herpeakgem,
  title={DeepTutor: Towards Agentic Personalized Tutoring},
  author={Zhao, Bingxi and Zhang, Jiahao and Ren, Xubin and Guo, Zirui and Chu, Tianzhe and Ma, Yi and Huang, Chao},
  journal={arXiv preprint arXiv:2604.26962},
  year={2026}
}

---

Note: HerPeakGem is built on the research foundation of DeepTutor by Zhao et al. (2026). All academic citations and references are preserved as-is.

---

---

🚀 加入AtomCollide-AI智能体实验室

元素碰撞-AtomCollide-AI 智能体实验室 是一个专注于AI领域的开源组织，汇聚了众多优秀学习者。

核心价值

找工作：更省力，也更精准

• 一线大厂内推通道（字节、阿里、腾讯等）
• 全链路求职赋能包（面试题库、简历优化、晋升指导）
• 线下技术沙龙 & 人脉网络

学AI测试：真正落地，拒绝空谈

• 从0到1实战落地体系（Skills、MCP、RAG、AI IDE等）
• 独家自研资料与工具矩阵
• 前沿技术同步与提效方案

知识库

• 踩坑合集
• 商业化案例库
• 科普专栏
• Open Build
• LLM/Agent/研究报告知识库
• Skill封装合集
• 社区治理运营知识库

加入社群

社群	链接
AI探索交流1区	加入
AI探索交流2区	加入
AI探索交流3区	加入
AI探索交流4区	加入
AI探索交流5区	加入
AI探索交流6区	加入
AI探索交流7区	加入
AI探索交流8区	加入
AI探索交流9区	加入
AI探索交流10区	加入
AI探索交流-网文作家	加入
AI探索交流群-音乐达人	加入
AI探索交流群-微笑驿站	加入

---

AtomCollide-智械工坊团队出品

---

组织与社群入口

元素碰撞 · AtomCollide-AI 智能体实验室：面向学习者、创作者与自动化实践者，持续沉淀可复用的 AI Agent 产品、工作流与工程经验。使命：for the learner。

请选择 1 个常用社群加入，内容全域同步，无需重复加入。

知识库

知识库	链接
踩坑合集	进入
商业化案例库	进入
科普专栏	进入
Open Build	进入
LLM / Agent / 研究报告	进入
Skill 封装合集	进入
社区治理运营	进入

社群邀请

社群	链接
AI 探索交流 1 区	加入
AI 探索交流 2 区	加入
AI 探索交流 3 区	加入
AI 探索交流 4 区	加入
AI 探索交流 5 区	加入
AI 探索交流 6 区	加入
AI 探索交流 7 区	加入
AI 探索交流 8 区	加入
AI 探索交流 9 区	加入
AI 探索交流 10 区	加入
AI 探索交流 — 网文作家	加入
AI 探索交流群 — 音乐达人	加入
AI 探索交流群 — 微笑驿站	加入

---

AtomCollide-智械工坊团队出品。更多产品见：AtomCollide Product Matrix。

Governance Links

• LICENSE
• CHANGELOG
• SECURITY
• CONTRIBUTING

2026-07-03 产品收敛门禁

• 新增 scripts/product_convergence_gate.py：从远端干净 clone 后可运行 python3 scripts/product_convergence_gate.py --json，检查 SKILL/README、入口文件、smoke 目标、测试与外部融合引用是否自洽。
• 新增 tests/test_product_convergence_gate.py：确保门禁在产品仓库中真实可执行，避免后续增强只停留在孤岛模块。