What X Won't Show You (And Why That's OK)
The repo deliberately withholds some things to reduce gaming
What's Not in the Repo
The X algorithm repo is open source — but it's not complete. The README explicitly states that some things are withheld:
Deliberately Withheld
- 1.LLM prompts used by content-classification systems — the prompts that drive automated labeling are not published
- 2.Some abuse-detection rules — specific rules that would allow bad actors to evade detection are not included
Why This Is Good
X is transparent about *why* these are withheld: to reduce gaming. If every abuse-detection rule were public, bad actors could engineer around them. By withholding the specifics, the system is harder to game.
What This Means for You
- The tutorial is honest about its limits. We can teach you what's in the repo — and we're upfront about what isn't.
- You don't need the withheld info to grow. The ranking weights, sourcing systems, filters, and adjustments are all public. That's more than enough to work with.
- Trust is the moat. By being the source that says "here's what we know, here's what we don't, and here's the file that proves it" — we build more trust than sites that claim to know everything.
The Full List of What IS in the Repo
30+ services, mostly Rust:
home-mixer/— the core ranking pipelinethunder/— in-network sourcingphoenix/— out-of-network ML retrievalsimclusters/— community detectionvisibility-filtering/— trust/safetyunder-the-hood/— transparency toolbotmaker/— bot detectionscarecrow/— rule enforcementuser-cred-v2/— account credibilityagatha/— (classification system)clip/— content understandingvm-ranker/— value model ranking- And more
This is more than enough to understand how the feed works. The parts that are withheld are the parts that would help bad actors — and they don't help you grow legitimately.
Check Your Understanding
1. What does the repo deliberately withhold?
- A. The ranking weights
- B. LLM prompts for content classification and some abuse-detection rules✓ correct
- C. The filtering logic
- D. The scoring formula
Why: The README states that LLM prompts and some abuse-detection rules are withheld to reduce gaming.
2. Why are some things withheld?
- A. To keep the code private
- B. To reduce gaming by bad actors✓ correct
- C. Because they're not ready
- D. Because they're patented
Why: X is transparent: withholding specific abuse-detection rules makes them harder to evade.
3. Is the withheld information needed to grow on X?
- A. Yes — you need to know everything
- B. No — the public ranking weights, sourcing, and filters are enough✓ correct
- C. Only for large accounts
- D. Only for verified accounts
Why: The public repo contains more than enough to understand and work with the feed algorithm.
Exercise
Bookmark the repo: github.com/xai-org/x-algorithm. Whenever you see a claim about "the X algorithm" online, check if the source links to a specific file. If it doesn't, treat it with skepticism.
Hint: The repo is updated regularly. The "Experiments and Configuration" section says defaults are synced from production.