# twisted/twisted

Event-driven networking engine written in Python.

Repository: https://github.com/twisted/twisted
Canonical: https://ross.abutalabs.com/products/twisted
Homepage: https://twisted.org
Language: Python
License: NOASSERTION
License Family: other
Topics: python, twisted, async, async-python, network, event-driven, http, irc, dns, xmpp, imap, smtp, tls, ssl
Last push: 2026-08-26T14:22:09+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 51, longevity 100
- inputs: {"age_days": 5542, "days_push": 7, "days_rel": 114, "gap_med": 187, "n_releases_24m": 4}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5977, forks 1221 (observed 2026-08-28T04:09:33.938284+00:00)

## What it is
Twisted is an event-driven networking engine and framework for Python, providing an asynchronous reactor plus implementations of many internet protocols. It includes subprojects for HTTP clients/servers, SSH, DNS, mail (IMAP/POP3/SMTP), and chat protocols (IRC, XMPP), along with a unit testing framework.

## Use cases
- write an async TCP echo server in python
- build an event-driven HTTP server or client
- implement custom network protocols in python
- run an SSH or telnet server from python
- send and receive email programmatically with SMTP and IMAP
- write a DNS server or client in python
- build a chat bot for IRC or XMPP

## When to choose
- you need fine-grained control over network protocols in Python
- you need built-in support for many protocols (SSH, DNS, mail, IRC) in one library
- you're maintaining an existing Twisted-based codebase
- you need an event loop that integrates with GUI toolkits or custom reactors

## When to avoid
- you're starting a new project where asyncio is sufficient
- you only need simple HTTP requests (use requests/httpx instead)
- your team is unfamiliar with Deferred-based callback style
- you want a modern async/await-first API without legacy patterns

## Facets
- artifact type: framework
- maturity: stable
- function: web-framework, http-server, http-client, websocket, networking, concurrency, ssh, email, testing, middleware
- domain: networking, web-development, backend, developer-tools, microservices
- platform: python, cross-platform, windows, cli
- tags: event-driven, async, reactor, tcp, udp, dns, tls, deferred, protocols, linux, macos

## Member repositories
- twisted/twisted (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:33.938284+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-29T17:50:07.895488+00:00, confidence not recorded.
  - readme: https://github.com/twisted/twisted (fetched 2026-08-28T04:09:33.938284+00:00, sha 31af16596f4d)
  - homepage: https://twisted.org (fetched 2026-08-29T08:46:29.090474+00:00, sha a646f1ad182c)
  - registry_pypi: https://pypi.org/pypi/twisted/json (fetched 2026-08-29T08:46:29.101635+00:00, sha ae5a9e8c146d)
- Data as of 2026-08-30T08:39:29.467469+00:00.