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.
TwitterGod now supports custom AI servers, allowing you to integrate your own AI models. Configure the following in .env
:
CUSTOM_AI_API_KEY="your_api_key" # API key for your custom AI server.
CUSTOM_AI_MODEL="your_model_name" # Model name for your custom AI.
CUSTOM_AI_URL="your_server_url" # URL of your custom AI server.
To handle AI failures, TwitterGod includes a retry mechanism:
MAX_AI_RETRIES=3 # Maximum number of retries for AI-generated responses.
TwitterGod can reuse previously scraped tweets to avoid redundant scraping:
USE_ALREADY_SCRAPPED_TWEETS_TO_REPLY="true" # Enables the use of already scraped tweets for replies in the files data/tweets_to_reply* json files.
USE_ALREADY_SCRAPPED_TWEETS_TO_REPLY_MAX_DAYS_OLD=4 # Maximum age (in days) of scraped tweets to be reused.
Receive notifications on your Android device when the script completes:
API_NOTIF_ANDROID="your_api_key" # API key for Android push notifications.
Android app GooglePlay Link: Push Notifcation API Not yet available on the App Store, if needed, please contact the developer on telegram t.me/tweetsyncai
TwitterGod includes advanced settings for updating account pools:
POOL_UPDATER_NUMBER_USERS_TO_SCRAP_AT_ONCE=2 # Number of users to scrape at once during pool updates.
POOL_UPDATER_MAX_POOL_USERS_TO_SCRAP=2 # Maximum number of users to scrape per pool update.
POOL_UPDATER_RANGE_DELAY_BETWEEN_SCRAPE="39-85" # Delay range (in seconds) between scrapes during pool updates.
POOL_UPDATER_SCRAP_DATA_RETRY=3 # Number of retries for scraping data during pool updates.
TwitterGod allows you to define a business personality for AI-generated responses:
BUSINESS_PERSONALITY_AI="I'm a passionate crypto degen with a knack for spotting the next moonshot..." # Define the personality of the AI.
EXAMPLE_RESPONSE_AI="🚀 Just found this hidden gem with insane potential!..." # Example response format.
BUSINESS_EXTRA_INFO_AI="Content focuses on high-potential low-cap tokens..." # Additional business context for AI responses.
KEY_TRAITS_AI="- Share thrilling, FOMO-inducing experiences..." # Key traits for AI-generated content.
TwitterGod includes proxy session management to ensure smooth operation: When running the python script to add your user, set your proxy and choose the proxy type,
Available proxy types:
HTTP
HTTPS
SOCKS5
TEST_MODE_ERROR_PROCESSING_ACTIONS="true" # always set to true, it won't change anything but it will detect if an accounts is banned and move it to the error_accounts folder or the pool in use
For more information, visit the screenshots.
--