TweetSync

TwitterGod Documentation

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.

Key Features

1. Customizable Keyword Tracking

Track trending tweets aligned with your business goals by specifying keywords. TwitterGod automatically identifies and engages with relevant tweets.

2. Targeted Engagement

Engage with tweets from specific profiles. Provide a list of profiles, and TwitterGod will scrape and interact with their latest tweets.

3. Personalized Tweet Generation

Craft tailored replies using AI models to resonate with your target audience. Define the tone, style, and content strategy for maximum impact.

4. Massive Output Capacity

Manage over 50,000 tweets/replies with ease using multiple Twitter accounts. Scale your presence effortlessly.

5. Real-Time Monitoring

Track logs, actions, and performance via a web dashboard. Download detailed reports for further analysis.

6. Flexible Execution Time

Schedule operations to complete within 30 minutes to 24 hours, depending on your strategy.

7. Account Warming Features

Gradually increase account activity to mimic organic behavior and reduce the risk of account suspension.


Configuration

TwitterGod can be configured entirely through the .env file and command-line parameters. Below are the detailed configuration options:

General Settings

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.

Trending Tweet Filters

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.

Scraper Settings

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.

Engagement Settings

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.

AI Settings

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.

Notification Settings

API_NOTIF_ANDROID="k-xxxxxxxxx" # API key for Android push notifications. Allows users to receive completion alerts.

Pool Management

RANGE_MAX_USER_PER_POOL="80-95" # Sets the range of accounts to include in a single operational pool.

Warming-Up Configuration

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.

Profile Updater Settings

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.

Command-Line Parameters

Modes

  • --warmer: Activates account warming mode.
  • --update_pool_info: Updates the account pool data.
  • --update_profiles_accounts: Updates profile information (names, bios, location, URLs).

Execution

  • --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].

Safety Features

  1. AI Behavioral Simulation: Ensures diverse, contextually relevant replies.
  2. Retry Mechanism: Limited retries for failed actions to avoid detection.
  3. Dynamic Pool Management: Rotates accounts to spread activity.
  4. Controlled Interaction Limits: Sets daily caps and variance for human-like behavior.
  5. Cooling-Off Delays: Random delays to prevent triggering rate limits.
  6. Low-Risk Actions: Gradual activity increase during warming-up.

Additional Notes

Profile Updater Feature

Modify accounts_updater_data_profiles.json with new names, bios, locations, and URLs. TwitterGod will automatically update each account based on the specified configuration.

Testing and Debugging

Enable TEST_MODE_ERROR_PROCESSING_ACTIONS="true" in .env for detailed error processing in test scenarios.


Why Choose TwitterGod?

  • Efficiency: Faster, smarter, and scalable engagement.
  • Flexibility: Fully customizable settings for targeted operations.
  • Safety: Advanced safety mechanisms to protect your accounts.
  • Transparency: Real-time monitoring and detailed reporting.

New Features and Updates

1. Custom AI Server Integration

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.

2. Retry Mechanism for AI

To handle AI failures, TwitterGod includes a retry mechanism:

MAX_AI_RETRIES=3 # Maximum number of retries for AI-generated responses.

3. Use Already Scraped Tweets [ Reply Mode ]

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.

4. Android Notifications

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

5. Pool Updater Settings

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.

6. Business Personality for AI

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.

7. Proxy Session Management

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

8. Extra

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.

--