Our take
Inactiveno commits in over a year- Activity
- 19
- Community
- 69
- Issues
- 21
- Pull requests
- 20
-1 stars in the last 30 days
Twython is a focused Python wrapper with broad contributor history, but its inactive status and lack of recent maintenance make current Twitter API compatibility an adoption risk.
Good fit if
- You need a Python 3 library for Twitter API calls or streaming, and its supported endpoints meet your needs.
- You are maintaining an existing Twython integration or can verify the required API behavior yourself.
- You value its MIT license and can work with a project that has many contributors and no recent commits.
Look elsewhere if
- Your application depends on recent upstream fixes or releases, since the project has had no commits in over a year and no releases in the past year.
- You need active issue or pull-request handling, with no issues closed or pull requests merged in the last 90 days.
- You require a library with verified compatibility against the current Twitter API.
All health signals
| Last commit | 2022-07-30 (4.3 years ago) |
|---|---|
| Commits, last 90 days | 0 |
| Releases, last 12 months | 0 (latest v3.9.1, 2021-07-16) |
| Contributors | 81 (top contributor: 55% of commits) |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 0 |
| Project age | 17 years |
Checked on 2026-11-02 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,856Forks
388Change since Nov 17, 2026: 0 stars·0 forks
Overview
Twython is a pure-Python library for accessing Twitter's API, including both standard API calls and the Streaming API. It gives Python applications a single wrapper for retrieving Twitter data and performing supported account actions, rather than requiring developers to assemble API requests themselves.
It is aimed at Python developers building applications that work with Twitter data, such as timelines, user information, lists, direct messages, or image uploads. The repository supports Python 3; its recorded health status is inactive, so teams should weigh that against their need for ongoing compatibility and maintenance.
Key Features
- Calls Twitter API endpoints for user information, lists, timelines, and direct messages.
- Supports Twitter's Streaming API.
- Handles OAuth 1 user authentication and OAuth 2 application-only, read-only authentication.
- Supports uploading images to update a status, avatar, background image, or banner.
- Maps keyword arguments to API endpoint parameters, allowing flexible endpoint queries.
- Supports Python 3.
Use Cases
- A Python web application lets users authenticate with Twitter and interact with their timelines.
- A data collection script retrieves Twitter API data or listens to the Streaming API.
- An application publishes status updates or changes profile images through Twitter.
- A read-only tool accesses Twitter data using application-only OAuth 2 authentication.
What you need
Detected in the repository
- Python (from setup.py)
- A test suite
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Install from PyPI:
pip install twython
See the README and Twython documentation for authentication and usage details.
Considerations
The health data marks the repository inactive: there have been no commits in over a year, no releases in the past year, and no recorded issue closures or merged pull requests in the last 90 days. Although 81 contributors have participated and contributions are not concentrated in one person, that history does not establish current maintenance. The project requires Python; no Docker or Compose setup is listed. It is MIT-licensed, a permissive license, but adopters should still review its terms and confirm that the library's API behavior fits their application.
Found this useful?
Share it with someone who would like twython.