bypy

Bypy is a Python command-line client for Baidu Yun, a Chinese cloud storage service that offers 2 terabytes of free personal storage. The main reason it exists is to let people use that storage from a Linux terminal, including on small devices like a Raspberry Pi, where no official desktop app is available. It works on Windows too, though that has been tested less thoroughly.

Once installed with a single pip command, you run bypy from the terminal and authorize it once by following a login prompt. After that, you can list files on the cloud, upload your current folder, download from the cloud, or compare what is local against what is stored remotely. The compare command is highlighted in the README as particularly useful for keeping two locations in sync without redundant transfers.

One constraint is worth knowing upfront: due to permission restrictions in the Baidu API, the program can only read and write to a specific subfolder on your cloud account, specifically the path called /apps/bypy. It cannot access the rest of your Baidu cloud storage. This is a platform limitation, not something the project controls.

The tool supports Unicode and Chinese filenames, retries failed transfers automatically, handles recursive uploads and downloads across folders, and caches file hashes to avoid rehashing the same content repeatedly. A basic graphical interface is also available by running bypygui if you prefer to avoid the terminal.

The project is now in maintenance mode. No new features will be added, and updates will only happen if a critical bug is found. The README is bilingual in Chinese and English, reflecting its original focus on Chinese users running Linux servers or small single-board computers.