callie0313/dylan-heartbeat

What it solves

Dylan Heartbeat is a runtime plugin for Kelivo AI companions that transforms them from reactive chatbots into proactive entities. It solves the problem of AI "forgetting" the user during silence, allowing the AI to maintain a continuous sense of time and context, and proactively reach out to the user via mobile notifications even when the user hasn't sent a message.

How it works

The project implements a gateway architecture consisting of two main components:

1. Gateway (server.js): Acts as a proxy between the Kelivo client and the LLM API. It maintains an "AI World Timeline" (enhanced_messages.json) that records both real conversations and the AI's own proactive behaviors (like sent notifications), ensuring the AI remembers its own initiative.
2. Wake-up Runtime (wake_up.js): A scheduled process that periodically wakes the AI. Based on configurable thresholds (different for day and night), the AI decides whether to send a notification or remain silent.

It uses a Timestamp Memory Bank to track the original timing of messages, allowing proactive notifications to be inserted into the conversation history at the correct chronological positions, even if the client strips timestamps.

Who it’s for

Users of the Kelivo AI companion app who want their AI characters to feel more "alive" and present through proactive communication, long-term temporal awareness, and automated journaling.

Highlights

• Proactive Wake-up: Automatically triggers AI thinking and outreach based on time elapsed since the last user interaction.
• Mobile Push Notifications: Integration with Bark (iOS) and ntfy (Android/Desktop) for real-time alerts.
• Temporal Awareness: Maintains a persistent timeline and memory of when it last contacted the user.
• Weather Integration: Optionally injects real-time local weather data into the AI's context during wake-up events.
• Automated Journaling: Allows the AI to save private diaries in Markdown format when it outputs specific tags.
• Web Management Console: A built-in admin panel for real-time configuration and service restarts.