semvec/pypi-packages huggingface dataset:
tor-proxy 0.0.4
A simple way to send your requests with tor using tor-proxy.
License: MIT License
Requires Python: >=3
Keywords: flask, tor, onion, stem, proxy, tor-proxy

# Tor-Proxy

A simple way to send your requests with tor using tor-proxy.It doesn’t interfere with other tor processes on your computer, so you can use the Tor Browser or the system tor on their own.

 [![PyPI version](https://badge.fury.io/py/tor-proxy.svg)](https://badge.fury.io/py/tor-proxy)
 [![Downloads](https://pepy.tech/badge/tor-proxy/month)](https://pepy.tech/project/tor-proxy)
 [![Downloads](https://static.pepy.tech/personalized-badge/tor-proxy?period=total&units=international_system&left_color=green&right_color=blue&left_text=Total%20Downloads)](https://pepy.tech/project/tor-proxy)
 ![Python 3.6](https://img.shields.io/badge/python-3.6-yellow.svg)


### Disclaimer:-
Use it only for educational purpose.

## Features
- No need root permission
- Multiple instances

## Compatability
Python 3.6+ is required.

## Installation

```bash
pip install tor-proxy
```

## Quickstart

1. Import with ```from tor_proxy import tor_proxy``` .
2. call function `tor_proxy()` , store as variable and give it as port argument in proxies.

```python
# tor_proxy_example.py
from tor_proxy import tor_proxy
import requests

port = tor_proxy()

http_proxy  = f"socks5h://127.0.0.1:{port}"
https_proxy = f"socks5h://127.0.0.1:{port}"

proxies = { 
              "http"  : http_proxy, 
              "https" : https_proxy, 
            }

url = "https://api.ipify.org"

r = requests.get(url, proxies=proxies)

print(r.text)
```

## Command Line Usage

After installing, you can run the Tor proxy service directly from the command line:

```bash
tor-proxy
```

This will start the Tor SOCKS proxy and print the port it is running on.

```sh
$ tor-proxy
connecting_to_tor: 100% - Done
Tor SOCKS proxy running on port: 47863
```

### Additional Command Line Options

- Run as a background (detached) process:

  ```bash
  tor-proxy --detach
  ```
  This will start the Tor proxy in the background.

- Kill all running Tor processes started with `/usr/bin/tor -f /tmp/...`:

  ```bash
  tor-proxy --kill
  ```
  This will find and terminate all matching Tor processes.

Now you can use this port as proxy in code.

```python
# tor_proxy_example.py
import requests

port = 47863

http_proxy  = f"socks5h://127.0.0.1:{port}"
https_proxy = f"socks5h://127.0.0.1:{port}"

proxies = { 
              "http"  : http_proxy, 
              "https" : https_proxy, 
            }

url = "https://api.ipify.org"

r = requests.get(url, proxies=proxies)

print(r.text)
```

### Credit :- [onionshare](https://github.com/onionshare/onionshare)