Skip to main content

Quick Start Guide

Get FlavumHive up and running in minutes! This guide assumes you've already completed the installation.

5-Minute Setup​

1. Basic Configuration​

# Clone and setup
git clone https://github.com/yourusername/flavumhive.git
cd flavumhive
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

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

2. Start Twitter Bot​

python continuous_twitter_bot.py

3. Start Reddit Bot​

python main.py --platform reddit

First Steps​

1. Monitor Your Bots​

# Watch Twitter logs
tail -f twitter_bot.log

# Watch general logs
tail -f bot.log

2. Check Bot Status​

python manage_bot.py status

Basic Operations​

Managing Twitter Bot​

# Start in background
nohup python continuous_twitter_bot.py &

# Stop bot
python manage_bot.py stop

Managing Reddit Bot​

# Start Reddit bot
python main.py --platform reddit

# Stop with Ctrl+C

Quick Configuration​

Adjust Rate Limits​

Edit config.json:

{
  "platforms": {
    "twitter": {
      "rate_limits": {
        "tweets_per_hour": 5,
        "min_delay_between_actions": 30
      }
    }
  }
}

Change Active Personality​

Edit config.json:

{
  "platforms": {
    "twitter": {
      "personality": {
        "active": "crypto_researcher"
      }
    }
  }
}

Common Commands​

Health Check​

# Run tests
python run_tests.py

# Check logs
tail -f twitter_bot.log

# View status
python manage_bot.py status

Maintenance​

# Clear debug files
./cleanup.sh

# Reset database
python -c "from utils.db_init import initialize_database; initialize_database()"

What's Next?​

1. Explore Features​

2. Customize Behavior​

  • Create custom personalities
  • Adjust rate limits
  • Configure monitoring

3. Advanced Usage​

  • Set up Docker deployment
  • Implement custom handlers
  • Add new platforms

Quick Troubleshooting​

Bot Not Posting​

  1. Check rate limits in config.json
  2. Verify credentials in .env
  3. Review twitter_bot.log

Authentication Issues​

  1. Verify credentials
  2. Check Chrome/Selenium setup
  3. Clear browser cache

Rate Limiting​

  1. Adjust in config.json
  2. Monitor logs for warnings
  3. Check platform limits

Need Help?​