Skip to content

Update ascend quick install documentation with dynamic configuration#107

Open
hipudding wants to merge 7 commits intoAscend:mainfrom
hipudding:main
Open

Update ascend quick install documentation with dynamic configuration#107
hipudding wants to merge 7 commits intoAscend:mainfrom
hipudding:main

Conversation

@hipudding
Copy link
Collaborator

@hipudding hipudding commented Feb 25, 2026

Dynamic ascend version configuration and build fixes
Changes

  • Dynamic config: Fetch ascend version data from hiascend API during build
  • Multithreading: Optimize data fetching with worker pool (CPU core count)
  • macOS build fix: Restrict torch_npu to Linux platform only
  • Makefile optimization: Use target dependencies to skip redundant operations
image

- Add fetch_ascend_data.py script to fetch latest data from hiascend.com
- Add ascend_config.json with version, product series, CPU architectures, OS, and install methods
- Refactor ascend_actions.js to load from config and dynamically generate UI
- Update quick_install.rst to use dynamic selection
- Update Makefile to fetch ascend data on each build
- Fix conf.py to handle missing torch_npu gracefully

The dynamic selection now supports:
- Version selection (8.5.0, 8.5.0.alpha002)
- Product series selection
- CPU architecture selection
- Operating system selection
- Install method selection
- Dynamic display of installation steps and commands
@ascend-robot
Copy link

CLA Signature Pass

hipudding, thanks for your pull request. All authors of the commits have signed the CLA. 👍

- Use CPU core count for worker threads instead of fixed 10
- Replace absolute output path with relative path
- Implement task queue pattern for parallel API requests
- Delete runtime-generated ascend_config.json from repo
@ascend-robot
Copy link

CLA Signature Pass

hipudding, thanks for your pull request. All authors of the commits have signed the CLA. 👍

- Fix shell syntax error in Makefile (removed stray 2. and .)
- Restrict torch_npu to Linux platform only (not available on macOS)
- Use venv for building
- Use directory targets for submodules to skip if already exists
- Make copy-docs depend on submodule directories
- Remove clean-submodules call to avoid re-initializing
- Use Make's built-in target mechanism instead of shell checks
@ascend-robot
Copy link

CLA Signature Pass

hipudding, thanks for your pull request. All authors of the commits have signed the CLA. 👍

@hipudding hipudding marked this pull request as ready for review February 28, 2026 02:19
@hipudding hipudding requested review from fffrog and zheliuyu and removed request for zheliuyu February 28, 2026 02:19
cpu_arch_id = task['cpu_arch_id']
os_id = task['os_id']
install_methods = get_install_methods(version_id, hardware_id, cpu_arch_id, os_id)
print(f" [{threading.current_thread().name}] Found {len(install_methods)} install methods for {os_id}")
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The meaning of this log message seems a bit unclear. I think we should either clarify what's happening here or just remove it — either is fine.

Image

@git submodule update --init --remote

# Copy documentation from submodules
copy-docs: _repos/verl _repos/VeOmni _repos/LLaMA-Factory _repos/ms-swift
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please rebase this part of the code so we can verify the documentation builds successfully during review.

Image

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additionally, should we also provide a jump link for "More Versions" so that users can access other CANN versions?

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants