Skip to content

Releases: krazyguy/Gelegram

v1.2.0

20 May 17:36

Choose a tag to compare

New:

  • /run: Execute preset shell commands from run.json (zero latency)
  • /cron: View and manage scheduled automation jobs
  • scheduler.py: Pure-stdlib cron engine (interval/daily/weekly/one-shot)
  • Skills for run-commands and cron-scheduler (agent self-manages via chat)

Fixed:

  • Gateway Unicode crash on Windows (cp1252 -> UTF-8)
  • Generic memory distillation (no hardcoded names)

v1.0.0 - Initial Release

13 May 06:35

Choose a tag to compare

🤖 Gelegram v1.0.0 — Initial Release

Your personal AI agent, accessible from Telegram and powered by Gemini CLI.
Set it up in one command. Runs 24/7. Knows who you are.


✨ What's Included

Core Bot

  • Telegram ↔ Gemini CLI bridge over JSON-RPC 2.0 (ACP protocol)
  • Multi-chat isolation — each chat gets its own independent Gemini session
  • File attachment support — send photos, documents, audio, video to your agent
  • Media album support — multiple photos delivered as a single grouped prompt
  • Auto-tool approval — Gemini can edit files, run scripts, and search the web
  • /kill command — cancel a long-running task without resetting the session
  • /reset, /private, /status commands
  • Optional bot password to restrict access

Agentic Workspace

  • Auto-scaffolded workspace on first run (memory, skills, projects structure)
  • Bootstrap Mode — agent walks you through identity setup on the very first message
  • Persistent identity via SOUL.md, IDENTITY.md, MEMORY.md
  • Memory distillation skill — converts session transcripts into long-term memory summaries
  • Pluggable skills system — drop a SKILL.md into skills/ to extend the agent

Resilience & Service

  • gateway.py watchdog with exponential backoff restart (5s → 120s)
  • Startup Gemini CLI path validation — warns early if misconfigured
  • Two-layer crash recovery: OS service → gateway → bot

Cross-Platform Setup

  • setup.ps1 — one-command onboarding for Windows
    • Installs Node.js (winget → MSI fallback), uv, Gemini CLI
    • Configures .env, installs NSSM Windows service
  • setup.sh — one-command onboarding for Linux and macOS
    • Installs Node.js (nvm → apt/dnf/pacman → Homebrew)
    • Configures .env, installs systemd user service (Linux) or launchd LaunchAgent (macOS)
    • Self-heals missing XDG_RUNTIME_DIR/D-Bus context on headless SSH servers

🚀 Quick Start

Windows

git clone https://github.com/krazyguy/Gelegram.git
cd Gelegram
powershell -ExecutionPolicy Bypass -File setup.ps1

Linux / macOS

git clone https://github.com/krazyguy/Gelegram.git
cd Gelegram
chmod +x setup.sh && ./setup.sh

📋 Requirements

  • Python 3.11+
  • Node.js 18+
  • A Telegram bot token from @BotFather
  • A Google account (for Gemini CLI OAuth)

The setup script installs Node.js, uv, and Gemini CLI automatically if missing.


🔗 Links