🔐 Private AI Signal Bot

This project is a lightweight, Dockerized AI chatbot that listens to your personal Signal messages via a prefix (!ai, !img, !code, !weather) and routes them to an LLM via a Cloudflare AI Worker.

🚀 Features

• 🔒 Private: Uses your personal Signal number securely.
• 💬 Prefix Parsing: Responds to commands like !ai, !img, !code, !weather.
• 🌩️ Fast & Cheap: Cloudflare Worker with AI Gateway.
• 🐳 Fully Dockerized using docker-compose.
• ⚙️ Minimal: Built in Go for performance and small footprint.

📦 Structure

my-ai-signal-bot/
├── bot/
│   ├── main.go
│   ├── go.mod
│   └── .env
├── worker/
│   └── Cloudflare Worker code for routing AI requests
├── docker-compose.yml
└── README.md

🛠 Setup Instructions

1. Clone and configure

git clone https://github.com/youruser/my-ai-signal-bot.git
cd my-ai-signal-bot
cp bot/.env.example bot/.env  # then fill it out

2. Link your Signal device

docker-compose run signalbot signal-cli link -n my-signal-bot-name

This should generate a url that you need to generate a QR code for. Scan the QR code using your Signal app.

3. Start the bot

docker-compose up -d

4. Deploy the Cloudflare Worker

cd worker
npm install
npx wrangler deploy

🧠 How It Works

• The Go bot uses signal-cli to receive messages.
• Supported commands:
  • !ai <prompt> → LLM completion
  • qq <prompt> → LLM completion
  • 🤖 <prompt> → LLM completion
• Replies are returned and sent via Signal.

💬 Example Usage

Message	Bot Response
hello	Ignored
!ai What is AI?	LLM response

📜 License

GPLv3