txtorcon
Twisted-based Tor controller client, with state-tracking and configuration abstractions. https://txtorcon.readthedocs.org https://github.com/meejah/txtorcon
Decision gist · record as of 2026-08-14
Yes, if you need to control or monitor Tor from Python. The library is actively maintained, has no known vulnerabilities, installs with low friction, and is MIT-licensed. Not relevant for applications that do not need direct Tor control.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a running Tor daemon accessible via control socket; Python 3.8+ required.
- Low install friction; pure Python wheel with no compiled dependencies.
- Actively maintained as of 2026-06-01.
License · maintenance · safety
MIT (permissive) — MIT-licensed under permissive terms, allowing use in commercial and proprietary projects with minimal restrictions.
last release 2026-06-01 (74 days) · last repo commit 2026-06-01 · 260 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 695,097 downloads/mo, #5,310 on PyPI
Alternatives
Verify before relying
pip install txtorcon
import txtorcon
tor = await txtorcon.connect(reactor)
print(f"Connected to Tor {tor.version}")- Whether Automat and Twisted are explicitly listed as runtime dependencies in package metadata (description mentions them but deps.runtime is empty).
- Specific version constraints for Twisted or Automat compatibility.
- Whether the example code in the description excerpt is representative of typical usage patterns.
What it is and what it does
txtorcon implements the Tor control specification for Python, allowing programs to connect to a running Tor instance and issue commands asynchronously. It abstracts Tor's control protocol into Python objects representing circuits, relays, and configuration, making it practical to embed Tor functionality into larger applications.
Typical usage involves connecting to a local or remote Tor control socket, then issuing commands: fetching live stream updates, building circuits through specific relays, reading and modifying Tor configuration, or launching hidden services. The library integrates with endpoint systems, so Tor-routed connections can be used transparently in servers and clients.
Use it for
- Monitor Tor relay and stream activity in real time from a Python event loop.
- Automate onion service deployment and management via the control protocol.
- Create a Tor controller tool that tracks circuit state and relay information.
- Build a proxy or client that routes traffic through Tor circuits programmatically.
- Integrate Tor anonymity into existing Python applications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to control or monitor Tor from Python.
The library is actively maintained, has no known vulnerabilities, installs with low friction, and is MIT-licensed. Not relevant for applications that do not need direct Tor control.
Install
txtorcon on PyPI
Before you install
Low install friction; pure Python wheel with no compiled dependencies. Actively maintained as of 2026-06-01.
Requires a running Tor daemon accessible via control socket; Python 3.8+ required.
License in practice
MIT-licensed under permissive terms, allowing use in commercial and proprietary projects with minimal restrictions.
Quickstart
pip install txtorcon
import txtorcon
tor = await txtorcon.connect(reactor)
print(f"Connected to Tor {tor.version}")Verify before relying
- Whether Automat and Twisted are explicitly listed as runtime dependencies in package metadata (description mentions them but deps.runtime is empty).
- Specific version constraints for Twisted or Automat compatibility.
- Whether the example code in the description excerpt is representative of typical usage patterns.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 74 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 695,097 / month, #5,310 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaFramework :: TwistedIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: POSIX :: LinuxOperating System :: UnixProgramming Language :: PythonProgramming Language :: Python :: 3Topic :: InternetTopic :: Internet :: Proxy ServersTopic :: SecurityTopic :: Software Development :: Libraries :: Python Modules |
Evidence: txtorcon-26.6.0-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 › “tor controller client python”
- txtorcontxtorcon is a client library for controlling and monitoring Tor…
- stemStem is a Python controller library for interacting with Tor,…
- tplink-omada-clientA Python client library for interacting with TP-Link Omada SDN…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also stem · irc · treq · Twisted · ldaptor · pytest-twisted · cirq · py-builder-relayer-client · pynput-robocorp-fork · os-ken