# python-twitter-tools/twitter

Python Twitter API

Repository: https://github.com/python-twitter-tools/twitter
Canonical: https://ross.abutalabs.com/products/twitter
Homepage: http://mike.verdone.ca/twitter/
Language: Python
License: MIT
License Family: permissive
Archived: true
Last push: 2025-02-10T18:45:41+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 6, release rhythm 8, longevity 100
- inputs: {"age_days": 6470, "days_push": 569, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3287, forks 711 (observed 2026-08-28T04:07:53.817385+00:00)

## What it is
Python Twitter Tools (PTT) is a minimalist Python wrapper for the Twitter API, whose methods map directly to Twitter API URLs. It also ships with a command-line client for reading and posting tweets and an IRC bot that announces Twitter updates to IRC channels.

## Use cases
- post tweets from the command line
- read my friends' timelines from a shell
- call the Twitter API from Python
- announce tweets to an IRC channel
- build a simple Twitter bot in Python

## When to choose
- you want a tiny, minimalist Twitter API wrapper with methods bound directly to API endpoints
- you prefer managing Twitter from the terminal
- you need an IRC bot that relays Twitter updates

## When to avoid
- you need full-featured Twitter/X API coverage including newer v2 endpoints
- you need OAuth-heavy or media-rich workflows out of the box
- you need a library under active feature development

## Facets
- artifact type: library
- maturity: maintenance
- function: http-client, cli, chatbot
- domain: apis, social-media, developer-tools
- platform: python, cli, cross-platform
- tags: twitter-api, twitter-client, irc-bot, social-media-api, command-line

## Member repositories
- python-twitter-tools/twitter (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:53.817385+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:22:54.901224+00:00, confidence not recorded.
  - readme: https://github.com/python-twitter-tools/twitter (fetched 2026-08-28T04:07:53.817385+00:00, sha 2b7814d3fca2)
  - homepage: http://mike.verdone.ca/twitter/ (fetched 2026-08-29T09:35:58.932534+00:00, sha 425aa9bb8e4e)
- Data as of 2026-08-30T08:39:29.467469+00:00.