{"id":13595310,"url":"https://github.com/twitter/communitynotes","last_synced_at":"2025-05-14T09:06:55.530Z","repository":{"id":43393807,"uuid":"332814342","full_name":"twitter/communitynotes","owner":"twitter","description":"Documentation and source code powering Twitter's Community Notes","archived":false,"fork":false,"pushed_at":"2025-04-10T18:12:02.000Z","size":115666,"stargazers_count":1657,"open_issues_count":48,"forks_count":240,"subscribers_count":61,"default_branch":"main","last_synced_at":"2025-05-14T09:06:13.941Z","etag":null,"topics":["crowdsourcing","twitter"],"latest_commit_sha":null,"homepage":"https://twitter.github.io/communitynotes","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/twitter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-01-25T16:43:18.000Z","updated_at":"2025-05-14T07:58:40.000Z","dependencies_parsed_at":"2023-02-15T03:46:06.188Z","dependency_job_id":"3ff0a593-40b1-4d8c-9e7c-6a8a92b5f9eb","html_url":"https://github.com/twitter/communitynotes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitter%2Fcommunitynotes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitter%2Fcommunitynotes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitter%2Fcommunitynotes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/twitter%2Fcommunitynotes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/twitter","download_url":"https://codeload.github.com/twitter/communitynotes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110374,"owners_count":22016391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crowdsourcing","twitter"],"created_at":"2024-08-01T16:01:47.456Z","updated_at":"2025-05-14T09:06:55.435Z","avatar_url":"https://github.com/twitter.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Community Notes\n\n![](/documentation/images/help-rate-this-note-expanded.png)\n\n## Welcome to Community Notes's public repository\n\nThis repository is a place for us to transparently host our content, algorithms, and share updates about the program.\n\nThe folder `/sourcecode` holds the [open-source code](https://github.com/twitter/communitynotes/tree/main/sourcecode) powering Community Notes under the hood.\n\nThe folder `/documentation` holds the [Markdown content](https://github.com/twitter/communitynotes/tree/main/documentation) that is used to generate our [documentation website](https://communitynotes.x.com/guide).\n\nHere you can also find our [research paper](https://github.com/twitter/communitynotes/blob/main/birdwatch_paper_2022_10_27.pdf).\n\n## About Community Notes\n\nCommunity Notes aims to create a better informed world, by empowering people on X to add helpful notes to posts that might be misleading.\n\nWe're building it in the open, with the public’s input, and we’re taking significant steps to make Community Notes transparent.\n\n## Sign up and become a Community Notes contributor\n\nOur goal is to expand Community Notes globally. We want anyone to be able to participate and know that having contributors with different points of view is essential to Community Notes helpfully addressing misinformation.\n\nAs there are important nuances in each market, we’ll expand the contributor base country-by-country. We’ll add contributors from a first new country soon.\n\n[Sign up here](https://x.com/i/flow/join-birdwatch)\n\n## How to contribute to this repo\n\nThank you for your interest in contributing to Community Notes! Currently, we will consider pull requests that contribute to the following areas:\n* Downstream analyses of scoring model output\n* Alternate scoring algorithm ideas (outside the core algorithm)\n* Documentation (in the documentation directory, not the sourcecode directory)\n* Open issues\n\nNote that we aren’t currently accepting changes that alter existing APIs, as there is other utility and production infrastructure code at X that depends on these APIs remaining stable.\n\nAlso note that we are unlikely to merge any minor documentation/typo/comment cleanup pull requests that touch the sourcecode directory due to our heavyweight deployment process (this code is developed in a separate internal repo and exported to Github whenever we deploy an update to the scorer). We are more likely to merge changes that edit the documentation directory only, and don't edit latex (since the documntation website described below parses latex differently than Github).\n\nWe are also exploring ways to make it easier for people to contribute directly to the core algorithm. For example, by making available testing and evaluation frameworks that would allow open source contributors to evaluate the impact of their PRs on note quality.\n\n---\n\n### Documentation website\n\nThe markdown files in this repo are the source of truth for the content in our documentation website (aka \"Community Notes Guide\"). They are always updated here first, then ingested by X's internal tools, translated, and published in [communitynotes.x.com/guide](https://communitynotes.x.com/guide).\n\n### Community Notes open-source code\n\nThe algorithm that powers Community Notes can be found in the [sourcecode folder](https://github.com/twitter/communitynotes/tree/main/sourcecode), and instructions on how to use it can be found in the [Guide](https://twitter.github.io/communitynotes/note-ranking-code/).\n\nWhile your normal Python install may \"just work\" if you're lucky, if you run into any issues and want to install the exact versions of Python packages that we've tested the code with, please create a new virtual environment and install the packages from requirements.txt:\n\n```\n$ python -m venv communitynotes_env\n$ source communitynotes_env/bin/activate\n$ pip install -r requirements.txt\n```\n\nThen after downloading the data files (see next section) into /sourcecode/, you will be able to run:\n\n```\n$ cd sourcecode\n$ python main.py\n```\n\nMultiple versions of Python3 should work, but we have tested the code with Python 3.10.\n\n### Community Notes data\n\nAll notes, ratings, and contributor data are [publicly available and published daily here](https://x.com/i/communitynotes/download-data). Instructions on how to use them can be found in the [Community Notes Guide](https://communitynotes.x.com/guide/under-the-hood/download-data/).\n\n### Community Notes paper\n\nWe've published a paper that details the research, analysis and outcomes that informed the program's development and helped us understand its performance. You can find it [here](https://github.com/twitter/communitynotes/blob/main/birdwatch_paper_2022_10_27.pdf).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwitter%2Fcommunitynotes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwitter%2Fcommunitynotes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwitter%2Fcommunitynotes/lists"}