Skip to content

[Feature] Add Windows Installer for ABACUS - #7267

Merged
mohanchen merged 7 commits into
deepmodeling:developfrom
Critsium-xy:windows_installer
Apr 22, 2026
Merged

[Feature] Add Windows Installer for ABACUS#7267
mohanchen merged 7 commits into
deepmodeling:developfrom
Critsium-xy:windows_installer

Conversation

@Critsium-xy

@Critsium-xy Critsium-xy commented Apr 20, 2026

Copy link
Copy Markdown
Collaborator

I add a install-abacus.bat file. Running this file will install ABACUS Windows Version on the machine (Not exactly windows version in fact).

However, this way of installation relies on using Miniconda to pack the environment. So it can only run the version on Miniconda (LTS Version) now.

How to use:

image

This just works😋👍

image

@Flying-dragon-boxing

Flying-dragon-boxing commented Apr 20, 2026

Copy link
Copy Markdown
Collaborator

As a software package that originates from USTC, USTC mirrors may be used rather than Tsinghua ones. https://mirrors.ustc.edu.cn/

@Critsium-xy

Copy link
Copy Markdown
Collaborator Author

As a software package that originates from USTC, USTC mirrors may be used rather than Tsinghua ones. https://mirrors.ustc.edu.cn/

Oh my god, why didn't you say so earlier?😧

@ZhouXY-PKU

Copy link
Copy Markdown
Collaborator

Maybe a WARNING log can be added at the beginning: This package is ONLY for demo and learning purposes, DO NOT try to run production jobs on your laptops.

@Critsium-xy
Critsium-xy marked this pull request as ready for review April 21, 2026 03:04
@Critsium-xy

Critsium-xy commented Apr 21, 2026

Copy link
Copy Markdown
Collaborator Author

Recommended for some user who what to quickly test a demo on Windows machine. Don't burn your windows machine with this thing (You can, but not recommend)

Critsium-xy and others added 4 commits April 22, 2026 12:35
…MPI-as-root, env forwarding

- Strip CR on the fly when piping provision.sh into bash so CRLF from git
  autocrlf or Windows editors no longer breaks shell parsing; add a
  tools/windows/.gitattributes pinning *.sh to LF and *.bat/*.cmd to CRLF.
- Replace the `wsl -d ... true` distro probe with a registry query, which
  is not fooled by lingering Store appx state after --unregister.
- Flatten the distro-install block and drop `& exit /b` so `if errorlevel 1`
  reads the runtime errorlevel of wsl.exe rather than the parse-time one,
  which was causing the window to close silently after install.
- Let `wsl --update` / `wsl --install -d` output flow to the console so
  users see Microsoft's download progress bar instead of a silent hang.
- Forward OMP_NUM_THREADS / MKL_NUM_THREADS / OPENBLAS_NUM_THREADS through
  WSLENV, default to 1 in the Linux wrapper to avoid oversubscription.
- Allow OpenMPI / PRRTE to run as root inside WSL (flag + env vars) so
  abacus-mpi works without creating a non-root user.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Documents the WSL2 + conda-forge pipeline, requirements, usage (serial /
MPI / hybrid), performance notes, file layout, troubleshooting table, and
a two-tier uninstallation section that distinguishes removing only ABACUS
from fully removing WSL via `wsl --uninstall`.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Adds docs/quick_start/windows_installer.md mirroring the README that ships
next to the scripts in tools/windows/, wires it into the Quick Start
toctree in docs/index.rst, and adds a cross-reference from easy_install.md
so Windows users discover the scripted path instead of building from
source or following WSL setup manually.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@mohanchen mohanchen added Refactor Refactor ABACUS codes Features Needed The features are indeed needed, and developers should have sophisticated knowledge labels Apr 22, 2026

@mohanchen mohanchen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Nice!

@mohanchen
mohanchen merged commit 6beefd0 into deepmodeling:develop Apr 22, 2026
15 checks passed
@Critsium-xy
Critsium-xy deleted the windows_installer branch May 6, 2026 05:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Features Needed The features are indeed needed, and developers should have sophisticated knowledge Refactor Refactor ABACUS codes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants