# reflections
KayaBot Live Relay & Telegram Journal Analytics Portal
KayaBot Active (v2.1) GitHub Repo ↗
#

Welcome to #reflections!

This is the official documentation and interactive preview stream for KayaBot. Offline, privacy-first reflection familiar, real-time Discord webhook stream, and analytical time-capsule engine for personal Telegram channels.

🥪
KayaBot APP Today at 10:20 AM
Here are the Interactive Analytical Dashboards compiled by the analytics suite. All demos below were generated directly from our 400-message synthetic benchmark (ChatExport_sample/) with zero private reflections exposed. Click any card to launch the standalone report:
🖋️ KayaBot • Analytical Master Dossier
All-in-one unified intelligence dossier combining Circadian, Lifecycle, Wrapped, and On-This-Day metrics with interactive Plotly visual charts and hero KPIs.
Dataset Benchmark
Synthetic (Dec 2023 – Sep 2026)
Query Latency
~0.2s Parquet Cache
Deliverable Format
Standalone Dark-Mode HTML
🚀 Launch Master Dossier (dashboard.html) ↗ python -m scripts.run_all --open
🖋️ KayaBot • Retrospective Engine
Spotify Wrapped-style interactive dark-mode story deck highlighting annual writing volume, book page equivalents, streak continuity, top fixation tags, and circadian personas (e.g. The Midnight Philosopher).
Persona Archetype
The Midnight Philosopher 🦉
Scope Flexibility
--year 2024 or --all-time
🖋️ KayaBot • Time Capsule Engine
Multi-year calendar engine querying what you wrote on today's calendar date across every past year. Features photo indicators, active spans, and compact glassmorphism cards.
⌛ Open On This Day (on_this_day.html) ↗ python -m scripts.run_otd --date 09-15
🖋️ KayaBot • Topic Discovery Engine
Normalizes bracket tags [tag], computes monthly turnover matrices, and classifies lifespans into Evergreen Passions, Seasonal Bursts, and Emerging Eras via 16-color qualitative streamgraphs.
🖋️ KayaBot • Circadian Profiler
Analyzes reflection timestamps to calculate 24-hour message density, peak journaling hours, weekly rhythm heatmaps, and longitudinal Night Owl Index shifts.
🥪 18
📊 14
✨ 12
🚀 16
🥪
KayaBot APP Today at 10:22 AM
Here is a snapshot preview of the publication-quality visualization charts compiled by the static visual pipeline:
Tag Streamgraph
📈 Topic Streamgraph: Monthly tag density and interest surges across synthetic timeline
Weekly Heatmap
📅 Weekly Circadian Heatmap: Journaling density by day of week and hour of day
Tag Lifespans Gantt
🌱 Tag Lifespans Gantt: Categorizing passions into Evergreen, Seasonal, and Emerging eras
🥪
KayaBot APP Today at 10:24 AM
KayaBot Companion Commands & Live Channel Relay:
KayaBot runs 24/7 in the background via macOS launchd, listening for channel reflections, streaming them to Discord with circadian-coded border aesthetics, and handling personal DM commands:
/otd Multi-year flashback for today's calendar date
/stats Instant scorecard: entries, words, book pages, circadian persona
/random Surface an unexpected serendipitous memory card
/tag <name> Deep-dive into an interest tag (e.g. /tag reading)
/delete <id> Purge reflection across Telegram channel, Discord mirror & archive
/reconcile Probe recent channel posts to reconcile direct channel deletions
Quickstart Terminal Setup:
# 1. Clone repository
git clone https://github.com/Kimame04/kayabot.git
cd kayabot

# 2. Install dependencies & configure credentials
conda env create -f environment.yml && conda activate tele-journal
cp .env.example .env

# 3. Start 24/7 background companion daemon
python -m scripts.setup_daemon install

# 4. Run full analytics suite & open master dashboard
python -m scripts.run_all --open