Chappie Bot 🤖

An AI-powered social media management bot that automatically publishes curated content across multiple platforms including Telegram, Twitter, and WhatsApp. Built to work with chappie_server.

[Read the origin story (in Ukrainian): Part 1 | Part 2]

Features

• 🔄 Multi-platform posting (Telegram, Twitter, WhatsApp)
• 🤖 AI-powered content curation
• ⚡ Automated GitHub repository discovery
• 📊 Post scheduling and management
• 🎯 Custom bot commands

Quick Start

1. Clone the repository:

git clone https://github.com/Think-Root/chappie_bot.git
cd chappie_bot

2. Configure environment variables:

cp .env.example .env
# Edit .env with your configuration

3. Deploy with Docker:

docker compose up -d

Detailed Configuration

Required Environment Variables

Variable	Description
BOT_TOKEN	Telegram bot token from @BotFather
ADMIN_ID	Your Telegram user ID
CHANNEL_ID	Target Telegram channel ID
CHAPPIE_SERVER_URL	URL of your chappie_server instance
CHAPPIE_SERVER_BEARER	Authentication token for chappie_server
X_API_KEY	API key for X (Twitter) integration
X_URL	URL for self-hosted X API server

Optional Environment Variables

⚠️ Warning: WhatsApp integration is unofficial and may risk account suspension

Variable	Description	Default
ENABLE_CRON	Enable post collection cron job	false
WAPP_ENABLE	Enable WhatsApp integration	false
WAPP_JID	WhatsApp chat JID	-
WAPP_TOKEN	WhatsApp authentication token	-
WAPP_SERVER_URL	WhatsApp server URL	-

Bot Commands

Command	Description
/add [urls]	Add GitHub repositories to content queue
/next [count]	Preview upcoming posts
/gen [count]	Generate posts from GitHub trends
/info	View database statistics
/xsend	Send post to X (Twitter)

Dependencies

• Docker
• chappie_server
• Docker Compose (optional)
• X API Server (optional, for Twitter integration)
• WhatsApp Server (optional, unofficial and may risk account suspension)

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Setup

# Install Go
go mod download

# Run locally
go run ./cmd/bot/main.go

# Build binary
go build -o chappie_bot ./cmd/bot/main.go

License

This project is licensed under the BSD 2-Clause License - see the LICENSE file for details.