TwitterGod is the ultimate Twitter engagement bot that enables seamless automation of tasks like keyword tracking, targeted engagement, and personalized tweet generation. Designed to operate efficiently and safely, it offers a range of customizable features for optimal control and performance.
Track trending tweets aligned with your business goals by specifying keywords. TwitterGod automatically identifies and engages with relevant tweets.
Engage with tweets from specific profiles. Provide a list of profiles, and TwitterGod will scrape and interact with their latest tweets.
Craft tailored replies using AI models to resonate with your target audience. Define the tone, style, and content strategy for maximum impact.
Manage over 50,000 tweets/replies with ease using multiple Twitter accounts. Scale your presence effortlessly.
Track logs, actions, and performance via a web dashboard. Download detailed reports for further analysis.
Schedule operations to complete within 30 minutes to 24 hours, depending on your strategy.
Gradually increase account activity to mimic organic behavior and reduce the risk of account suspension.
TwitterGod can be configured entirely through the .env file and command-line parameters. Below are the detailed configuration options:
MAIN_MODE="tweet" # Defines the primary mode of operation: "tweet" for creating tweets or "reply" for responding to existing tweets.
AI_CHOICE="custom" # Specifies the AI model to use: "local", "openai", or "custom" for personalized setups.
RANDOM_DELAY="1-5" # Sets the range (in seconds) for random delays between actions to avoid detection.
RANDOM_DELAY_GENERAL="4-12" # General random delay range (in seconds) between various actions for natural behavior.
RANDOM_DELAY_FOR_TWEET_MODE="23-93" # Specific delay range (in seconds) for tweet creation actions.
MINIMUM_TWEET_TRENDINGS_LIKES=30 # Minimum number of likes for a tweet to be considered trending.
MINIMUM_TWEET_TRENDINGS_RETWEETS=20 # Minimum number of retweets for a tweet to qualify as trending.
MINIMUM_TWEET_TRENDINGS_REPLIES=50 # Minimum number of replies required for a tweet to be included.
LIMIT_SEARCH_TRENDING_TWEETS=60 # Limits the number of trending tweets fetched during a single scrape session.
MAX_DAYS_OLD_TWEETS=3 # Restricts the scraper to tweets no older than the specified number of days.
MAX_LATEST_TWEETS_FROM_PROFILE=6 # Limits the scraper to fetch only the most recent tweets (up to this count) from a profile.
MAX_TWEET_OR_REPLY_PER_DAY_PER_ACCOUNTS="3-4" # Sets the range of tweets or replies each account can perform daily.
ANSWER_NOTIF="false" # Enables or disables responding to notifications (beta feature, not recommended for production use).
RANGE_NOTIF_REPLY_PER_DAY="2-4" # Specifies the range of notification replies per day if ANSWER_NOTIF is enabled.
PERCENT_FOLLOW_BEFORE_REPLY=30 # Percentage probability of following a user before replying to their tweet.
MAX_CONTEXT=15 # Maximum context length for the AI when generating replies.
TEMPERATURE_VALUE=0.7 # Controls the creativity of AI responses. Higher values make outputs more diverse.
USE_HASHTAGS="true" # Determines whether the AI includes hashtags in generated replies.
MAX_USERS_TO_TAG_PER_TWEET=10 # Limits the number of user mentions per tweet to avoid appearing spammy.
BUSINESS_PERSONALITY_AI="I'm a conversational AI designed to resonate..." # Describes the personality and tone of the AI for replies.
EXAMPLE_RESPONSE_AI="@username Discover..." # Example format for AI-generated responses.
KEY_TRAITS_AI="- Make subtle references..." # Additional characteristics to shape AI responses.
API_NOTIF_ANDROID="k-xxxxxxxxx" # API key for Android push notifications. Allows users to receive completion alerts.
RANGE_MAX_USER_PER_POOL="80-95" # Sets the range of accounts to include in a single operational pool.
WARMER_GLOBAL_DELAY_BETWEEN_ACTIONS="25-39" # Global delay (in seconds) between warming-up actions.
WARMER_GLOBAL_DELAY_BETWEEN_USERS="5-12" # Delay (in seconds) between actions performed by different accounts.
WARMER_GLOBAL_INTERACTION_PROBABILITY=90 # Percentage probability of interactions during warming-up sessions.
WARMER_MAX_FOLLOWS_PER_ACCOUNT=1 # Maximum number of follows per account during warming-up.
WARMER_MAX_LIKES_PER_ACCOUNT=2 # Maximum number of likes per account during warming-up.
WARMER_MAX_RETWEETS_PER_ACCOUNT=0 # Maximum number of retweets per account during warming-up.
WARMER_INTERACTION_LIMIT_VARIANCE=20 # Adds a percentage-based variance to interaction limits for natural behavior.
WARMER_USE_POOLS_USERS_AS_FOLLOW_TARGETS="true" # Determines if pool users should be used as follow targets during warming-up.
UPDATE_PROFILES_TWITTERS_MAX_PROFILES_TO_UPDATE=5 # Maximum number of profiles to update during a single run.
UPDATE_PROFILES_TWITTERS_RANGE_DELAY_BETWEEN_UPDATE="39-85" # Delay range (in seconds) between profile updates.
UPDATE_PROFILES_TWITTERS_LAST_UPDATE_MAX_HOURS=168 # Excludes profiles updated within the specified number of hours.
--warmer: Activates account warming mode.--update_pool_info: Updates the account pool data.--update_profiles_accounts: Updates profile information (names, bios, location, URLs).--scrap_only: Scrapes tweets without engaging into any interactions, it will exit after scraping the trending and profiles tweets.--personality: Generates a personality for the selected users [Soon].Modify accounts_updater_data_profiles.json with new names, bios, locations, and URLs. TwitterGod will automatically update each account based on the specified configuration.
Enable TEST_MODE_ERROR_PROCESSING_ACTIONS="true" in .env for detailed error processing in test scenarios.
For more information, visit the screenshots.