aiohappyeyeballs

Happy Eyeballs for asyncio

aiohappyeyeballs Permissive license PSF-2.0 Active ★ 44 v2.7.1 released 2026-07-01

Install

aiohappyeyeballs on PyPI

pip

pip install aiohappyeyeballs

uv

uv add aiohappyeyeballs

poetry

poetry add aiohappyeyeballs

Package facts

License	PSF-2.0 (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	actively maintained — 43 days since the last release
Last repo commit	2026-08-10
First released	2023-12-09
Popularity	one of the 100 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: aiohappyeyeballs-2.7.1-py3-none-any.whl

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Python Software Foundation LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Libraries

About aiohappyeyeballs

from the package's own PyPI description — quoted content, verbatim

aiohappyeyeballs

<p align="center"> <a href="https://github.com/aio-libs/aiohappyeyeballs/actions/workflows/ci.yml?query=branch%3Amain"> <img src="https://img.shields.io/github/actions/workflow/status/aio-libs/aiohappyeyeballs/ci-cd.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" > </a> <a href="https://aiohappyeyeballs.readthedocs.io"> <img src="https://img.shields.io/readthedocs/aiohappyeyeballs.svg?logo=read-the-docs&logoColor=fff&style=flat-square" alt="Documentation Status"> </a> <a href="https://codecov.io/gh/aio-libs/aiohappyeyeballs"> <img src="https://img.shields.io/codecov/c/github/aio-libs/aiohappyeyeballs.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage"> </a> </p> <p align="center"> <a href="https://python-poetry.org/"> <img...

Read as markdown · JSON record · Source repository · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Implements Happy Eyeballs (RFC 8305) connection establishment for asyncio when you already have resolved addresses, enabling fast failover between IPv4 and IPv6 without waiting for timeouts.

Low friction: pure Python wheel with no runtime dependencies, actively maintained with recent releases, and supports Python 3.10–3.14.

Licensed under PSF-2.0 (Python Software Foundation License), a permissive license matching CPython's own terms, allowing free use in most contexts.

Usage

import asyncio
from aiohappyeyeballs import start_connection

addr_infos = await asyncio.get_event_loop().getaddrinfo("example.org", 80)
socket = await start_connection(addr_infos)
transport, protocol = await asyncio.get_event_loop().create_connection(
    MyProtocol, sock=socket)

Requires Python 3.10 or later; asyncio event loop must be running.

Verdict: Stable, actively maintained library in the top 100 PyPI packages with zero known vulnerabilities. Ideal for applications needing RFC 8305 Happy Eyeballs behavior when using pre-resolved addresses or alternative DNS methods; permissive PSF license and zero dependencies make adoption straightforward.

Needs verification

Whether the library is used by major async frameworks or is primarily for direct integration
Performance characteristics compared to stdlib create_connection for typical workloads

asyncio happy eyeballs connectionRFC 8305 dual stackfast ipv4 ipv6 failoverasyncio address resolutionhappy eyeballs pythonconcurrent connection attemptsipv6 ipv4 race condition