🤖 Haawa Bot

A feature-rich Discord bot with music, AI responses, moderation, and social media bridging.

🚀 Quick Start

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your tokens

# Run the bot
python bot.py

✨ Features

• 🎵 Music Player - Play YouTube music in voice channels
• 🤖 AI Responses - Flirty AI personality powered by g4f
• 🛡️ Moderation - Kick, ban, timeout, purge commands
• 📱 Social Bridges - Instagram DM & Messenger integration
• 📊 Statistics - Track user and server stats
• 🎮 Fun Commands - Games, memes, and more
• 💬 Slash Commands - Modern Discord interactions

📁 Project Structure

Haawa-Bot/
├── bot.py              # Main entry point
├── cogs/               # Command modules
│   ├── general.py      # Basic commands
│   ├── music.py        # Music player
│   └── ...
├── bridges/            # Social media integration
├── utils/              # Utilities (DB, AI, etc.)
└── docs/               # Documentation

📖 Documentation

• Quick Start Guide - Get started quickly
• User Manual - All commands and features
• Deployment Guide - Deploy to your VPS
• Migration Guide - Migrate from old structure

🎮 Commands

General

• haawa ping - Check bot latency
• haawa roll 2d6 - Roll dice
• haawa userinfo [@user] - User information
• haawa serverinfo - Server information

Music

• haawa play <song> - Play a song
• haawa pause - Pause playback
• haawa skip - Skip current song
• haawa queue - Show queue

AI

• haawa <message> - Chat with AI
• haawa imagine <prompt> - Generate images

🔧 Requirements

• Python 3.10+
• FFmpeg (for music)
• PostgreSQL (for database)
• Discord Bot Token
• Environment variables (see .env.example)

🚀 Deployment

VPS Deployment

git clone <your-repo>
cd Haawa-Bot
pip install -r requirements.txt
python bot.py

Using systemd (recommended)

# Create service file
sudo nano /etc/systemd/system/haawa-bot.service

# Enable and start
sudo systemctl enable haawa-bot
sudo systemctl start haawa-bot

🛠️ Development

# Install dependencies
pip install -r requirements.txt

# Run in development mode
export ENVIRONMENT=development
python bot.py

# Check logs
tail -f haawa-bot.log

📝 Environment Variables

Required:

• TOKEN - Discord bot token
• DATABASE_URL - PostgreSQL connection string

Optional:

• AI_MODEL - AI model to use (default: gpt-4o-mini)
• COMMAND_PREFIX - Bot prefix (default: "haawa ")
• LOG_LEVEL - Logging level (default: INFO)
• BRIDGE_CHANNEL_ID - Channel for social media bridges
• INSTAGRAM_USERNAME - Instagram username
• INSTAGRAM_PASSWORD - Instagram password

See .env.example for full list.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

MIT License - See LICENSE file for details

🆘 Support

• Check docs/ for detailed documentation
• Review logs: tail -f haawa-bot.log
• Open an issue for bugs or feature requests

🎉 Credits

#This may or may not be the preferred repo

Built with ❤️ using:

• discord.py
• yt-dlp
• g4f
• instagrapi

---

Made with 💕 by the Haawa Bot team