ruyi 0.39.0a20250731

Ruyi

The package manager for RuyiSDK.

Installation and usage

You can get pre-built binaries of ruyi from GitHub Releases or the RuyiSDK mirror for easier testing. Rename the downloaded file to ruyi, make it executable, put inside your $PATH and you're ready to go.

You can browse the documentation at the dedicated RuyiSDK docs site (only available in Chinese right now).

Configuration

Various aspects of ruyi can be configured with files or environment variables.

Config search path

ruyi respects $XDG_CONFIG_HOME and $XDG_CONFIG_DIRS settings, and will look up its config accordingly. If these are not explicitly set though, as in typical use cases, the default config directory is most likely ~/.config/ruyi.

Config file

Currently ruyi will look for an optional config.toml in its XDG config directory. The file, if present, looks like this, with all values being default:

[packages]
# Consider pre-release versions when matching packages in repositories.
prereleases = false

[repo]
# Path to the local RuyiSDK metadata repository. Must be absolute or the setting
# will be ignored.
# If unset or empty, $XDG_CACHE_HOME/ruyi/packages-index is used.
local = ""
# Remote location of RuyiSDK metadata repository.
# If unset or empty, this default value is used.
remote = "https://github.com/ruyisdk/packages-index.git"
# Name of the branch to use.
# If unset or empty, this default value is used.
branch = "main"

[telemetry]
# Whether to collect telemetry information for improving RuyiSDK's developer
# experience, and whether to send the data periodically to RuyiSDK team.
# Valid values are `local`, `off` and `on` -- see the documentation for
# details.
#
# If unset or empty, this default value is used: data will be collected and
# uploaded every week, on a random weekday determined by the installation's
# anonymous ID alone.
mode = "on"
# The time the user's consent is given to telemetry data uploading. If the
# system time is later than the time given here, telemetry consent banner will
# not be displayed any more each time `ruyi` is executed. The exact consent
# time is also useful should the telemetry policy get updated in the future.
#
# To hide the consent banner, set it to the current local time, for example:
#
#     upload_consent = 2024-12-02T15:61:00+08:00
#
# The timestamp is intentionally invalid for you to notice and modify to your
# need.
upload_consent = ""
# Override the telemetry server URL of the RuyiSDK package manager scope.
# If unset, the repo-configured default is used; if set to empty, telemetry
# uploading is disabled.
#pm_telemetry_url = ""

Environment variables

Currently the following environment variables are supported by ruyi:

• RUYI_TELEMETRY_OPTOUT -- boolean, whether to opt-out of telemetry.
• RUYI_VENV -- string, explicitly specifies the Ruyi virtual environment to use.

For boolean variables, the values 1, true, x, y or yes (all case-insensitive) are all treated as "true".

Telemetry

The Ruyi package manager collects usage data in order to help us improve your experience. It is collected by the RuyiSDK team and shared with the community. You can opt-out of telemetry by setting the RUYI_TELEMETRY_OPTOUT environment variable to any of 1, true, x, y or yes using your favorite shell. Opting out of telemetry is equivalent to the off mode described below.

There are 3 telemetry modes available:

• local: data will be collected but not uploaded without user action.
• off: data will not be collected nor uploaded.
• on: data will be collected and periodically uploaded.

By default the on mode is active, which means every ruyi invocation will record some non-sensitive information locally alongside various other states of ruyi, and collected data will be periodically uploaded to servers managed by the RuyiSDK team in the People's Republic of China, in a weekly fashion. The upload will happen on a random weekday which is determined by the installation's anonymous ID alone.

You can change the telemetry mode by editing ruyi's config file, or simply by setting the RUYI_TELEMETRY_OPTOUT environment variable to any of the values accepted as truthy.

We collect the following information with ruyi:

• the running machine's basic information:
  • architecture and OS
  • if architecture is RISC-V:
    • ISA capabilities
    • model name of the board
    • number of logical CPUs
  • OS release ID (roughly equals the distribution type)
  • type and version of libc
  • type of the shell (bash, fish, zsh, etc.)
• the version of ruyi on data upload time
• invocation patterns of various ruyi subcommands:
  • without exposing any parameters
  • invocation time is recorded with a granularity of 1 minute

You can see our Privacy Policy on the RuyiSDK website.

Contributing

We welcome contributions to Ruyi! Please see our contribution guidelines (中文) for details on how to get started.

License

Copyright © 2023-2024 Institute of Software, Chinese Academy of Sciences (ISCAS). All rights reserved.

ruyi is licensed under the Apache 2.0 license.

The one-file binary distribution of ruyi contains code licensed under the Mozilla Public License 2.0. You can get the respective project's sources from the project's official website:

• certifi: used unmodified

All trademarks referenced herein are property of their respective holders.