README.md
 1  # Arti Experiments
 2  
 3  **WARNING This example is not maintained.**
 4  It uses the obsolete and unmaintained `arti-hyper` crate.
 5  
 6  This is a small repo to learn more about [Arti](https://gitlab.torproject.org/tpo/core/arti), the experimental implementation of the Tor protocol written in Rust.
 7  
 8  Arti provides an API to integrate Tor network connectivity into other programs. Being written in Rust, Arti has the unique advantage of providing both a secure (memory-safe, type-safe etc) and anonymous interface to the clearnet and Deep Web for a variety of applications
 9  
10  This repo is an exploration into that space, and since Arti is in an alpha state, doing so would probably uncover bugs and missing information in docs.
11  
12  ## Overview
13  
14  This project aims to build a small download manager prototype which can connect to the Tor network and get a copy of the Tor browser from there.
15  
16  In order to speed up the process, it will make multiple connections (similar to popular download managers) to the server and use [HTTP Range header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests) to specify what portion of the file we wish to obtain.
17  
18  There are costs associated with each Tor connection, so some care must be taken to balance the speed benefits of a new Tor connection with the slow startup speed and overall network health.
19  
20  ## Setup
21  
22  Make sure you have Rust installed and ready to go.
23  
24  Clone this repo, and run ```cargo run```
25  to run the program. It will automatically fetch dependencies and compile the program.
26  
27  Right now, it only downloads a specific Linux build of the Tor Browser Bundle as a file "download.tar.xz".