README.md

Community notes explorer

Proposed Twitter (X) community notes from the last week, updated regularly. More…

https://andylolz.github.io/x-community-notes/

How it works

Community note data is fetched regularly from Twitter (X).

This data is always a couple of days old.

Notes are excluded if they meet any of the following criteria:

• Created more than a week ago
• Classifying the post as ‘not misleading’ (i.e. in support of the post)
• Currently rated ‘unhelpful’

We also attempt to filter out notes for deleted tweets and non-English tweets.

Running locally

Initial setup:

# Install python dependencies
poetry install

# Install ruby dependencies (Jekyll)
bundle install

# Copy template .env.example into place (and populate)
cp .env.example .env

If you just need some notes data and metadata:

curl -L -o output/data/notes.json https://github.com/andylolz/x-community-notes/raw/gh-pages/data/notes.json
curl -L -o output/_data/meta.json https://github.com/andylolz/x-community-notes/raw/gh-pages/_data/meta.json

Then to run:

# Start the development server
jekyll s -s output

If you want to download the notes yourself with python:

# Fetch notes
poetry run python -m x_notes

# Optional: fetch tweets
poetry run python -m x_notes.fetch_tweets