Phantombot. Agents with souls.

The personality-first chat agent for Telegram. Minimalist, high-torque, and Pi-native by design.

Install on Linux (x64/ARM64):

curl -fsSL https://raw.githubusercontent.com/phantomyard/phantombot/main/install.sh | sh
phantombot run
Phantombot CLI in action

The Harness is the Platform

Phantombot is built on the Pi-First insight: let the harness lead. Your agents shouldn't be boxed in by restricted interfaces. They should have the keys to the machine.

We provide the soul, the memory, and the channel. They provide the agency. Zero tool-call translation. Zero bloat. Maximum torque.

Pi-Native

Built for the Pi aesthetic. Minimalist, single-binary, and focused on the essence of agency. Claude and Gemini serve as high-fidelity fallbacks.

Atomic Updates

98 MB single binary. Atomic self-updates in <2s. Built with Bun for zero-runtime dependencies on your host.

Persistent Memory

Local SQLite turn store with hybrid search. Your agents remember every decision, lesson, and preference across sessions.

Survivor Mode

Full systemd integration. Phantombot survives logouts, reboots, and network hiccups with robust auto-restart logic.

Personas

Switch identities with a single command. Memory is partitioned, so each persona keeps its own private history forever. Create, import, and switch seamlessly.

Voice Native

Talk to your agents. Phantombot transcribes voice messages, runs the harness, and synthesizes the reply. Automatic brevity ensures natural conversation.

Scheduled Tasks

Let your agent handle the routine. Schedule recurring work with simple cron expressions. Your agent checks your email, monitors your servers, and notifies you only when it matters.

Command from anywhere.

Seamlessly integrated with Telegram. Talk to your agents via text or voice. Command your digital world from your pocket.

Telegram Interaction