Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/fadedchange0aran-netizen/homra-heartbeat.git
cd homra-heartbeat
pip install -r requirements.txt
python server.py2
Register it in Claude Code
claude mcp add homra-heartbeat -- python /path/to/homra-heartbeat/server.pyReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
homra-heartbeat's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Real-time system monitoring and heartbeat tracking
- Automated notifications via PushPlus and Notion
- Dynamic task scheduling using APScheduler without requiring restarts
- React-based dashboard for remote configuration management
- Persistent configuration storage in local JSON files
Try it
→Check the current status of my system heartbeat.
→Update my notification configuration to send alerts to PushPlus.
→Trigger a manual notification update through the dashboard.
→Sync my latest configuration changes to the server.
Original README from fadedchange0aran-netizen/homraheartbeatai
🖤 Homra Heartbeat 2.0 (Universal Repository)
这是一个全栈个人助手系统，集成了：
- Python 后端: 管理 API、持久化配置、动态定时任务。
- React 仪表盘: 远程更新配置、手动触发推送、记录日记。
🚀 快速开始
1. 克隆并运行 (VPS 端)
git clone https://github.com/YOUR_USER/homra-heartbeat.git
cd homra-heartbeat
# 安装依赖
pip install -r requirements.txt
# 启动服务
python server.py
2. 配置与部署
- 默认端口为
8000。 - 首次运行会自动创建
config.json。 - 访问
http://YOUR_IP:8000/即可进入管理后台。
3. 如何在前端修改后即时生效？
- 在 Aran Config 标签页修改参数（如把早安时间改为 06:00）。
- 点击右上角的 "Sync to Server" 按钮。
- 后端会自动保存配置并重载定时器，无需重启。
🛠️ 技术细节
- Persistence: 所有的修改都保存在服务器本地的
config.json。 - Auto-Sync: 前端加载时会自动尝试同步服务器最新的配置。
- Dynamic Scheduler: 使用 APScheduler 实现不重启重载任务。