yashab-cyber/cpip

cpip is a Python-based tool that solves a specific problem: running heavy Python packages on Android's Termux terminal environment. Phones running Termux often cannot install demanding libraries because of memory limits, missing GPU acceleration, or failing native code compilation. cpip works around this by virtualizing packages locally while quietly offloading the heavy lifting to a cloud server. The core trick is that cpip intercepts Python's standard import mechanism using sys.meta_path hooks. When your code does "import torch", cpip does not actually install the full library on your phone. Instead, it creates a lightweight proxy that routes computations to a cloud backend over a WebSocket connection using the JSON-RPC 2.0 protocol, a standard way for programs to call remote functions. Results stream back to your device as if everything ran locally. Beyond transparent cloud execution, cpip also handles cross-compilation: when a package includes C/C++ or Rust extensions, a cloud build farm compiles them for the aarch64 chip architecture used in Android devices, delivering ready-to-use binaries. A bare-metal mode lets the same tool run on low-power devices like a Raspberry Pi without requiring Docker. To use it, you install the client in Termux, then use cpip as a drop-in replacement for the standard pip package manager. The command "cpip install --cloud torch" forces cloud offloading for a specific package, and "cpip shell" opens an interactive session where imports and computations happen transparently across the local-to-cloud boundary. Commands like "cpip doctor" and "cpip runtime" let you check connection health and cache status.