Awesome

X Bot

Twitter / X bot for responding to user mentions with AI-generated answers.

Features

extremely robust (used on an acct w/ 150k+ followers)
supports multiple AI answer engines: openai, dexa, and perplexity
persists state to redis and caches all twitter objects to maximize quota usage
maximizes twitter api throughput w/ plan-dependent throttling
resolves structured entity data to give answer engines additional context
- includes things like links, twitter user profile info, quote tweets, etc
handles bot interactions such as:
- basic @mentions
- follow-up questions
- referencing quote tweets and retweets
- referencing mentioned users
- referencing content from links
- referencing content from embedded media (images, gifs, video; polls not yet supported)
uses a scoring heuristic for prioritizing which tweets to respond to when the bot goes viral
ignores known bot accounts to prevent them from endlessly replying to each other
supports running multiple bots w/ the same redis instance
thoroughly tested in production

Configuring the bot

You'll need a paid Twitter developer account and a Twitter v2 app with OAuth 2.0 enabled. You'll need to subscribe to at least the basic Twitter API plan in order to run this bot; the free tier is not supported since it doesn't support fetching tweets which is required for this bot to work.

Set up a .env file by copying .env.example and initializing all required environment variables.

Dependencies to call out:

Nango is used to simplify Twitter OAuth
OpenAI chat completions API is used as the default answer engine
- OpenAI's moderations endpoint is also used to filter out inappropriate tweets
Dexa is an excellent answer engine whose API is currently in private beta (otherwise it would be the default)
Redis is used to persist state across runs and cache twitter objects (tweets, users, mentions) in order to maximize our use of twitter API quotas
- Redis is optional, and if you don't specify a redis instance, state will be "persisted" to an in-memory store
- However, given twitter's quotas, using a redis instance to cache twitter objects is highly recommended

Setting TWITTER_API_PLAN to the correct plan is important, because this is used to determine the bot's internal twitter API throttling in order to avoid rate limits and maximize quota usage.

Running the bot

tsx bin/xbot.ts

Usage:
  xbot [flags...]

Flags:
  -a, --answer-engine <string>                      Answer engine to use (openai, dexa, or perplexity) (default: "openai")
      --debug                                       Enables debug logging
  -t, --debug-tweet-ids <string>                    Specifies a tweet to process instead of responding to mentions with
                                                    the default behavior. Multiple tweets ids can be specified (-t id1
                                                    -t id2 -t id3). Exits after processing the specified tweets.
  -d, --dry-run                                     Enables dry run mode, which will not tweet or make any POST requests
                                                    to twitter
  -e, --early-exit                                  Exits the program after resolving the first batch of mentions, but
                                                    without actually processing them or tweeting anything
  -f, --force-reply                                 Forces twitter mention validation to succeed, even if the bot has
                                                    already responded to a mention; very useful in combination with
                                                    --debug-tweet-ids
  -h, --help                                        Show help
  -n, --max-num-mentions-to-process <number>        Number of mentions to process per batch (default: 10)
      --no-mentions-cache                           Disables loading twitter mentions from the cache (which will always
                                                    hit the twitter api)
  -R, --resolve-all-mentions                        Bypasses the tweet mention cache and since mention id state to fetch
                                                    all mentions from the twitter api
  -s, --since-mention-id <string>                   Overrides the default since mention id

TODO