{"id":19164454,"url":"https://github.com/cupy/cupy-release-tools","last_synced_at":"2025-07-13T19:08:17.016Z","repository":{"id":38359614,"uuid":"119336076","full_name":"cupy/cupy-release-tools","owner":"cupy","description":"Tools for CuPy Release","archived":false,"fork":false,"pushed_at":"2025-07-08T01:56:57.000Z","size":723,"stargazers_count":8,"open_issues_count":16,"forks_count":12,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-07-08T21:24:18.023Z","etag":null,"topics":["cupy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cupy.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["cupy"]}},"created_at":"2018-01-29T05:27:10.000Z","updated_at":"2025-07-07T14:23:49.000Z","dependencies_parsed_at":"2024-02-08T21:01:42.344Z","dependency_job_id":"5d3211b6-0298-47dc-b3c9-2c17098ad369","html_url":"https://github.com/cupy/cupy-release-tools","commit_stats":{"total_commits":512,"total_committers":9,"mean_commits":"56.888888888888886","dds":0.099609375,"last_synced_commit":"326292408be6bc7f77f4335de7f34b7f29038678"},"previous_names":[],"tags_count":56,"template":false,"template_full_name":null,"purl":"pkg:github/cupy/cupy-release-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cupy%2Fcupy-release-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cupy%2Fcupy-release-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cupy%2Fcupy-release-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cupy%2Fcupy-release-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cupy","download_url":"https://codeload.github.com/cupy/cupy-release-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cupy%2Fcupy-release-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265108586,"owners_count":23712491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cupy"],"created_at":"2024-11-09T09:22:08.758Z","updated_at":"2025-07-13T19:08:16.997Z","avatar_url":"https://github.com/cupy.png","language":"Python","funding_links":["https://github.com/sponsors/cupy"],"categories":[],"sub_categories":[],"readme":"cupy-release-tools\n==================\n\nTools to automate the CuPy release process.\nThis tool is used to create both source distribution (``sdist``) and wheels.\n\nThe release process consists of 3 steps:\n\n1. Build\n2. Verify\n3. Publish\n\nRequirements\n------------\n\nLinux\n~~~~~\n\n* For ``sdist`` and CUDA (x86_64) wheel build, run the tool on Linux (x86_64). NVIDIA GPU + NVIDIA Container Toolkit are required for Verify step.\n* For CUDA (aarch64) wheel build, run the tool on Linux (x86_64 with QEMU (aarch64), aarch64, or Tegra). NVIDIA GPU + NVIDIA Container Toolkit is required for Verify step.\n* For ROCm wheel build, run the tool on Linux (x86_64). AMD GPU is required for Verify step.\n\nNotes:\n\n* To ensure the reproducibility of builds, the build environment is isolated by Docker.\n\nWindows\n~~~~~~~\n\n* Windows 8+ (x86_64)\n* Python, CUDA and Visual C++ are required. Versions depend on the target of the wheel.\n\nNotes:\n\n* Be aware that Windows tools in this repository is expected to be run on isolated virtual machine.\n  Especially note that the tool directly installs the dependency libraries to ``%CUDA_PATH%``.\n* ``sdist`` build on Windows is not supported.\n\nQuick Guide\n-----------\n\nFor Linux builds, you can use the ``build.sh`` shell script that wraps the Build and Verify steps.\n\n::\n\n  # Prepare source tree\n  git clone --recursive https://github.com/cupy/cupy.git\n\n  # Build \u0026 verify a sdist (using Python 3.10)\n  ./build.sh sdist 3.10\n\n  # Build \u0026 verify a wheel for CUDA 11.0 + Python 3.8\n  ./build.sh 11.0 3.8\n\nFor Windows, or if you need some more detailed configuration, see the sections below to manually run the tool.\n\nBuild\n-----\n\nThis tool can build wheels for Linux \u0026 Windows for supported CUDA/ROCm x Python variants defined in ``dist_config.py``.\n\nBuilding Distributions\n~~~~~~~~~~~~~~~~~~~~~~\n\n**IMPORTANT**: Always make sure to use a fresh, just-git-cloned CuPy source tree!\n\nTo build a sdist, use the following command.\n``--source`` is a path to the source tree.\n\n::\n\n  ./dist.py --action build --target sdist --python 3.6.0 --source path/to/cupy_repo\n\nTo build a wheel, use the following command.\nThis example builds wheel of CuPy with CUDA 10.0 for Python 3.8.\n\n::\n\n  ./dist.py --action build --target wheel-linux --python 3.8 --cuda 10.0 --source path/to/cupy_repo\n\nUse ``--target wheel-win`` for Windows build.\nUse ``--cuda rocm-5.0`` for ROCm (AMD GPU) build.\n\nThe resulting asset (sdist/wheel) will be generated to the current directory.\n\nWorking Directory (Linux)\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIt is safe to run multiple ``dist.py`` at a time.\nEach time you run the tool, a dedicated temporary directory (``/tmp/cupy-dist-XXXXX``) is created.\nThe temporary directory is shared with the builder docker container as a volume.\nThe working directory will be removed after the build.\n\nVerify\n------\n\nThe tool can be used to confirm that the built distribution can work on multiple environments.\n\nVerifying Distributions\n~~~~~~~~~~~~~~~~~~~~~~~\n\nTo verify the built distribution, use the following command:\n\n::\n\n  ./dist.py --action verify --target wheel-linux --python 3.8 --cuda 10.0 --dist cupy_cuda100-9.0.0b2-cp38-cp38-manylinux_x86_64.whl --test release-tests/common --test release-tests/cudnn --test release-tests/nccl\n\nYou can specify test suites directory to ``--test`` argument.\n``release-tests`` is a minimal test cases handy for final check before release.\nOf course, you can also run the full unit test suites from CuPy source tree.\n\nPublish\n-------\n\nUse ``twine`` command to upload distributions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcupy%2Fcupy-release-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcupy%2Fcupy-release-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcupy%2Fcupy-release-tools/lists"}