git404hub

what is xviral fr?

ninjahawk/xviral — explained in plain English

Analysis updated 2026-05-18

8RustAudience · pm founderComplexity · 3/5LicenseSetup · moderate

tl;dr

A tool that grades a draft X post the way the platform's own recommendation algorithm would, rebuilt from X's real published ranking code.

vibe map

mindmap
  root((XViral))
    What it does
      Scores draft posts
      Emulates platform AI judges
      Applies real ranking formula
    Tech stack
      Python
      Claude or Ollama
      Rust scorer code
    Use cases
      Preview post performance
      Spot spam or filler flags
      Compare against real post stats
    Audience
      Social media creators
      Growth and marketing researchers
    Findings
      Mutes hurt more than likes help
      Small accounts face spam checks
      Video needs minimum length

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Check how a draft X post might score before publishing it.

VIBE 2

See whether a post would trigger the platform's quality or spam judges.

VIBE 3

Compare a scored post's predicted engagement against its real public stats.

VIBE 4

Test different post variants to see which one the ranking formula favors.

what's the stack?

RustPythonClaudeOllama

how it stacks up fr

ninjahawk/xviraleternal-flame-ad/yume-pdqoop7/rquickshare-x
Stars888
LanguageRustRustRust
Last pushed2026-03-212026-05-15
MaintenanceMaintainedMaintained
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencepm founderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Python 3.11+ and either the Claude CLI or a locally running Ollama model as the judge engine.

in plain english

XViral is a tool that grades a draft social media post for X, formerly known as Twitter, the same way the platform's own recommendation algorithm would grade it, so you can see how a post might perform before you actually publish it. The project is built on real code. In May 2026, X published the actual production code behind its For You feed, the system that decides which posts get shown to people, along with a version of its trained ranking model. That release included the exact scoring formula and the categories it checks a post against, but it left out some of the specific numbers the real system uses internally, such as exact weight values and the wording of its internal AI judge prompts. XViral rebuilds that released pipeline so it can run locally on a post you have not published yet. It uses an AI model, either Claude or a model running on your own computer through a tool called Ollama, to stand in for the platform's internal AI judges, checking things like whether a post looks like generic filler content or spam. It then applies the same scoring formula from the real code to estimate how the post would be ranked. Along the way, the project found some things that common advice about the algorithm gets wrong or does not mention, such as every post being checked by a quality and spam judge, small accounts facing an extra spam check, actions like getting muted or reported hurting a post's score far more than a like helps it, and videos below a minimum length getting no credit at all, unlike the widely repeated claim that video always performs far better. The tool can also fetch real public engagement numbers for an already posted tweet, without needing to log in, so its predictions can be checked against what actually happened. The project is upfront that its numeric scores are not yet fully calibrated to match real world outcomes, and sets a specific accuracy target it wants to hit before treating the scores as reliable. To run it, you need Python 3.11 or newer along with either the Claude command line tool or a locally running Ollama model.

prompts (copy fr)

prompt 1
Explain how this tool uses AI to emulate X's real content quality and spam judges.
prompt 2
Walk me through scoring a draft post using the Claude CLI as the judge engine.
prompt 3
Help me understand why mutes and reports hurt a post's score more than a like helps it.
prompt 4
Show me how to fetch real engagement numbers for a posted tweet to compare against a prediction.

Frequently asked questions

what is xviral fr?

A tool that grades a draft X post the way the platform's own recommendation algorithm would, rebuilt from X's real published ranking code.

What language is xviral written in?

Mainly Rust. The stack also includes Rust, Python, Claude.

How hard is xviral to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is xviral for?

Mainly pm founder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.