responsiblparty/twitterverse

twitterverse is a Python tool that draws a solar-system-style picture of your X, formerly Twitter, posting circle. It works from a local archive created by another tool called birdclaw, so it needs no API keys, no secrets, and no cloud service to run. The picture puts you at the center as the sun, with your closest reply friends orbiting as planets, and shows shared connections between them as smaller satellites. The visualization is built to answer three questions at a glance: who are your closest posting friends over the last year based on how often you reply to each other, whether your posting activity has been speeding up or slowing down over the last six months compared to a steady pace, and which secondary accounts multiple of your top friends also reply to, since those shared connections are what hold a social scene together. Users install it with pip, then either try a built in demo mode that needs no database, or point it at their own birdclaw sqlite archive along with their X handle to generate a full HTML page. Because birdclaw does not store the user's own profile picture, there is an option to pass in that image's web address manually so it appears in the sun position. Under the hood, the tool extracts reply relationships from the archive in two directions, using a database join for replies made to the user and a text-parsing trick that reads the leading @handle mentions in the user's own replies to recover outgoing connections, since those often are not fully captured in the archive. It also classifies the user's recent posting trend into categories like heating up, steady, or cooling off. The README lists known rough edges in this early version, including overlapping labels when satellites are close together, and placeholder avatars for accounts not yet in the local profile data. It is released under the MIT license.