Signal-llm-bot

signal-llm-bot is a Signal-messenger bot that connects to a self-hosted LLM, so you can chat with AI from your phone via Signal messages.

Stack: Python, signal-cli, Docker. Private repo.

Architecture

Signal App (phone) → Signal Servers → signal-cli (subprocess) → bot.py → llama-swap / OpenAI-compatible endpoint

Features

• Chat with a local LLM via Signal messages.
• Conversation history (default 20 messages, configurable).
• Whitelist support — restrict who can use the bot.
• Commands: /help, /clear.
• Docker support (batteries included).

Setup

Register the bot's Signal account via signal-cli register --captcha from signalcaptchas.org, verify with the SMS code, then docker compose up -d.

Key env vars: SIGNAL_NUMBER, SIGNAL_CLI, SIGNAL_CONFIG, LLM_API_URL, LLM_MODEL, MAX_HISTORY.

Sources

• README

See also

• signal-integration — the fleet's Signal monorepo (signal-cli + MCP + clignal).