Skip to content

A tiny Tor client implementation (in pure python).

License

Notifications You must be signed in to change notification settings

Marten4n6/TinyTor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


         Logo
TinyTor

A tiny Tor client implementation (in pure python).

License Python Issues Build Status Contributing


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

License

GPLv3

About

A tiny Tor client implementation (in pure python).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages