aiodns
Simple DNS resolver for asyncio
Decision gist · record as of 2026-08-14
Yes. aiodns is a stable, actively maintained package (Production/Stable status, recent release, 594 GitHub stars) with low install friction and no known vulnerabilities. It fills a clear need for non-blocking DNS in asyncio applications. The MIT license is permissive. Install it if you need asynchronous DNS resolution in an asyncio codebase; the single dependency (pycares) is well-established. Avoid only if you have no asyncio requirement or prefer the standard library's synchronous socket.getaddrinfo().AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; on Windows with custom non-thread-safe pycares builds, requires asyncio.SelectorEventLoop or winloop instead of ProactorEventLoop.
- Low install friction with a single runtime dependency (pycares).
- Active maintenance with a recent release 86 days ago; supports current Python versions (3.10–3.14).
License · maintenance · safety
MIT (permissive) — MIT license (permissive) allows commercial and private use with minimal restrictions.
last release 2026-05-20 (86 days) · last repo commit 2026-08-01 · 594 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 20,518,305 downloads/mo, #1,034 on PyPI
Alternatives
Verify before relying
import asyncio
import aiodns
async def main():
resolver = aiodns.DNSResolver()
result = await resolver.query_dns('example.com', 'A')
for record in result.answer:
print(record.data.addr)
asyncio.run(main())- Whether the Windows event loop limitation (ProactorEventLoop incompatibility with non-thread-safe c-ares) affects prebuilt pycares wheels in practice.
- Performance characteristics and typical query latency compared to synchronous DNS resolution.
What it is and what it does
aiodns wraps pycares to provide asynchronous DNS resolution within asyncio applications. Instead of blocking on DNS lookups, it returns futures that resolve when the DNS query completes, allowing your event loop to handle other work concurrently. The main API is the DNSResolver class, which offers methods like query_dns() for standard lookups, gethostbyaddr() for reverse lookups, getaddrinfo() for socket-style resolution, and getnameinfo() for address-to-hostname conversion.
The package supports a wide range of DNS record types (A, AAAA, MX, CNAME, TXT, SRV, NS, SOA, CAA, NAPTR, PTR, ANY) and returns results as pycares DNSResult objects with answer, authority, and additional sections. Version 4.x introduced a new query_dns() method returning native pycares types; the older query() method remains for backward compatibility but is deprecated. The resolver is designed to be long-lived and reused across many queries rather than created and destroyed frequently.
Use it for
- Resolve hostnames to IP addresses asynchronously in web servers or network clients without blocking the event loop.
- Perform bulk DNS lookups (MX, TXT, CNAME records) in background tasks or monitoring tools.
- Implement reverse DNS lookups (gethostbyaddr) in logging or security audit systems.
- Build DNS-aware service discovery or load balancing logic that queries multiple record types.
- Test DNS resolution behavior in asyncio-based test suites using the async context manager pattern.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
aiodns is a stable, actively maintained package (Production/Stable status, recent release, 594 GitHub stars) with low install friction and no known vulnerabilities. It fills a clear need for non-blocking DNS in asyncio applications. The MIT license is permissive. Install it if you need asynchronous DNS resolution in an asyncio codebase; the single dependency (pycares) is well-established. Avoid only if you have no asyncio requirement or prefer the standard library's synchronous socket.getaddrinfo().
Install
aiodns on PyPI
Before you install
Low install friction with a single runtime dependency (pycares). Active maintenance with a recent release 86 days ago; supports current Python versions (3.10–3.14). Repository shows 594 stars and ongoing development.
Requires Python 3.10 or later; on Windows with custom non-thread-safe pycares builds, requires asyncio.SelectorEventLoop or winloop instead of ProactorEventLoop.
License in practice
MIT license (permissive) allows commercial and private use with minimal restrictions.
Quickstart
import asyncio
import aiodns
async def main():
resolver = aiodns.DNSResolver()
result = await resolver.query_dns('example.com', 'A')
for record in result.answer:
print(record.data.addr)
asyncio.run(main())Verify before relying
- Whether the Windows event loop limitation (ProactorEventLoop incompatibility with non-thread-safe c-ares) affects prebuilt pycares wheels in practice.
- Performance characteristics and typical query latency compared to synchronous DNS resolution.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepycares |
| Maintenance | Actively maintained 86 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 20,518,305 / month, #1,034 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: aiodns-4.0.4-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “asyncio dns lookup”
- aiodnsProvides asynchronous DNS resolution for asyncio applications using…
- py3dnsProvides synchronous DNS query functionality for Python 3, supporting…
- nslookupProvides high-level DNS lookups (A, AAAA, and SOA records) with clean…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also py3dns · pycares · aiohttp-asyncmdnsresolver · nslookup · aiodiscover · dnspython · aiohttp · kubernetes-asyncio · dns-lexicon · dnslib