casperac 0.3.1

Advanced zero-config dual-layer network anonymization wrapper (WARP + Tor) with Global VPN and Anti-Detect Engine.

CasperAC

Advanced Dual-Layer Network Anonymization CLI

---

CasperAC is an advanced, automated network anonymization CLI tool designed to wrap any terminal command (like curl, nmap, or wget) in a highly secure Dual-Layer (WARP + Tor) tunnel. It features a true Zero-Config Auto-Deploy engine that installs and configures its own VPN and proxy infrastructure automatically.

🌟 The Dual-Layer Privacy Architecture

CasperAC employs a state-of-the-art dual-layer network stack to ensure maximum privacy and prevent Deep Packet Inspection (DPI):

1. Layer 1: Cloudflare WARP (WireGuard VPN)
   • All your system traffic is encrypted and sent to Cloudflare's edge network.
   • Why? Your local Internet Service Provider (ISP) or network administrator cannot see that you are using Tor. They only see a standard Cloudflare connection.
2. Layer 2: The Onion Router (Tor)
   • Inside the WARP tunnel, CasperAC routes your specific terminal command through the Tor network.
   • Why? The Tor Entry Node sees Cloudflare's IP instead of your real IP. Finally, the target server sees a random Tor Exit Node IP.

Result: Your ISP doesn't know you use Tor, the Tor network doesn't know your real IP, and the target server doesn't know who you are.

✨ Features

• 🚀 Zero-Config Auto-Deploy: If Tor or Cloudflare WARP are not installed, CasperAC automatically downloads, installs, and configures them for you via system package managers (Homebrew/APT).
• 🛡️ Dual-Layer Security: Combines Cloudflare WARP with Tor for ISP-blind, exit-node-anonymized traffic.
• 🌍 Global VPN Mode: Instantly route your entire operating system (all browsers and apps) through the Tor network with a single command (casperac global-on).
• 🕵️‍♂️ Anti-Detect Engine: Intelligently evades bot-protection (like Cloudflare) by dynamically injecting realistic browser fingerprints (User-Agents, sec-ch-ua, Accept-Language) into terminal commands.
• 🔄 Dynamic IP Rotation: Effortlessly renew your Tor circuit with a single command to get a fresh IP address.
• 💻 Environment Management: Easily export or unset proxy environment variables for your current active shell session.

🚀 Usage

1. Status Check & Auto-Deploy

Check your network status. If Tor or WARP is missing, CasperAC will auto-deploy them.

casperac status

2. Command Proxying (Smart Wrapper)

Wrap any terminal command to automatically route it through Tor, with dynamic browser fingerprint injection.

casperac run -- curl ifconfig.me

Spoof Mobile Identity

casperac run --mobile -- curl ifconfig.me

3. Global VPN Mode (System-wide Tor)

Route your entire operating system (Safari, Chrome, Spotify, OS updates) through the Tor network. (Currently supported on macOS and Linux GNOME desktops).

casperac global-on

To disable and restore normal internet:

casperac global-off

4. Circuit Renewal

casperac renew

🚀 Installation

Prerequisites

• Python 3.8+
• Tor daemon installed and running locally on port 9050. Control port on 9051.
• Cloudflare WARP CLI (optional, but recommended for the dual-layer approach).

Setup via PyPI (Recommended)

pip install casperac

Setup from Source

git clone https://github.com/cagritas/casperac.git
cd casperac
pip install -e .

💻 Usage

# Check the status of your proxies
casperac status

# Run a specific command through the proxy chain
casperac run -- curl -I https://api.github.com/user

# Renew your Tor exit node
casperac renew

# Source proxy variables into your active shell session
eval $(casperac env-on)

# Revert proxy variables
eval $(casperac env-off)

🤝 Contributing

Contributions, issues and feature requests are welcome! Feel free to check issues page. You can also take a look at the contributing guide.

📝 License

Copyright © 2024. This project is MIT licensed.