TinyTor

A tiny Tor client implementation (in pure python).

This implementation is NOT FINISHED YET.

TinyTor can be used to communicate with onion services via Tor.
It may be used by developers as a python package or as a command line utility.

The goals are to have no dependencies, live in a single file and be as small as possible.
The current file size of TinyTor is only ~37KB (uncompressed).

Some warnings:

• TinyTor assumes OpenSSL is installed on the running machine (native on Linux/macOS)
• This project is not related to the official Tor Project
• For anything dependent on your privacy, please use the Tor Browser or Tails OS

How To Use

# Install TinyTor
$ sudo pip3 install tinytor

# Send a HTTP request over Tor
$ tinytor --host example.onion --verbose

From Source

# Download or clone this repository
$ git clone https://github.com/Marten4n6/TinyTor

# Go into the repository
$ cd TinyTor

# Send a HTTP request over Tor
$ python tinytor.py --host example.onion --verbose

For Developers

from tinytor import TinyTor

tor = TinyTor()
print(tor.http_get("example.onion"))

Motivation

TinyTor was created to communicate anonymously in EvilOSX.
compressed.py is used in EvilOSX, which compresses TinyTor to a much smaller size (about ~9KB).

Versioning

TinyTor will be maintained under the Semantic Versioning guidelines as much as possible.
Releases will be numbered with the follow format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

• Breaking backward compatibility bumps the major
• New additions without breaking backward compatibility bumps the minor
• Bug fixes and misc changes bump the patch

For more information on SemVer, please visit https://semver.org/.

Support Tor

The Tor network relies on volunteers to donate bandwidth.
Please consider running a relay. You can help make the Tor network:

• faster (and therefore more usable)
• more robust against attacks
• more stable in case of outages
• safer for its users (spying on more relays is harder than on a few)

For more information on volunteering, please visit https://www.torproject.org/getinvolved/volunteer.html.

Issues

Feel free to submit any issues here.

References

• Tor Protocol Specification
• Tor: The Second-Generation Onion Router
• Mini-tor
• Pycepa
• Struct
• How Tor Works: Part 1, 2, 3
• Logo created by motusora

License

GPLv3