CP2K is a professional scientific software for quantum chemistry and solid-state physics simulations. This project packages CP2K 2026.1 (latest) as a Windows one-click installer — no technical background required, just double-click to install.
Powered by Ubuntu 24.04 WSL2 + source-built CP2K 2026.1.
- Click the Actions tab at the top of the page
- Click the latest entry with a green checkmark
- Scroll to the bottom and click the installer under Artifacts →
CP2K-Windows-installer
- Unzip the
.zipfile to getCP2K_2026.1_Windows_Setup.exe - Right-click → Run as administrator and follow the prompts
💡 The installer is approximately 1–2 GB. Installation takes 3–5 minutes — please be patient.
This installer runs CP2K inside WSL2 on a single Windows PC — ideal for learning and testing, not for large-scale production.
| Scenario | Suitability |
|---|---|
| Learning & getting started | ✅ Excellent |
| Input file debugging | ✅ Excellent |
| Small system single-point / geometry optimisation | ✅ Good |
| Short AIMD runs | ✅ Acceptable |
| Large system calculations | ❌ Not suitable |
| Multi-node parallel computing | ❌ Not available |
| GPU-accelerated calculations | ❌ Not recommended |
| Long-term production runs | ❌ Unstable |
Local WSL2 (this installer) Remote Linux HPC
| |
Write input files Large-scale calculations
Test small systems Multi-node parallel jobs
Tune parameters Long production runs
Analyse results GPU acceleration
| |
└──── Validate locally, then submit ┘
Best practice: Treat WSL2 + CP2K as your development and testing environment, not a production computing platform.
The installer guides you through the entire process — no manual steps needed. Built-in checks and prompts include:
-
Pre-install checks
- Windows version requirement (Win10 2004 or later)
- Sufficient disk space (at least 6 GB on C drive)
- WSL2 availability (enabled automatically if missing)
-
Real-time progress
- Step 1/3: Import CP2K runtime environment (~2–4 min)
- Step 2/3: Configure system environment variables
- Step 3/3: Clean up temporary files
-
On failure
- A dialog appears explaining the exact cause and recommended fix
| Item | Requirement |
|---|---|
| OS | Windows 10 (version 2004 or later) or Windows 11 |
| RAM | 4 GB or more |
| Disk space | At least 6 GB free on drive C |
| Other | CPU must support virtualisation (enabled by default on most modern PCs) |
Not sure about your Windows version? Press
Win + R, typewinver, and press Enter.
A CP2K shortcut will appear on your desktop after installation.
Run a calculation:
- Double-click the CP2K desktop icon to open a shell, then type:
The shell tries to open in your Windows user home directory (
cp2k -i yourfile.inpC:\Users\<you>). If that path cannot be resolved inside WSL, it falls back to the Linux home directory.
Q: The installer says "virtualisation needs to be enabled"?
Restart, press Del or F2 to enter BIOS, find Virtualization Technology, set it to Enabled, save and restart.
Q: The installer enabled WSL2 but the import still fails after reboot?
Make sure Windows has fully restarted and finished applying the optional-feature changes. On Windows 10, you may also need to install the WSL2 Linux kernel update package: https://aka.ms/wsl2kernel
Q: My antivirus flagged the installer — is it safe? Temporarily disable real-time protection before installing, then re-enable it afterwards. WSL2 import operations are sometimes mis-flagged.
Q: Installation is stuck on "Importing runtime environment" — is that normal? Yes — this step takes 2–4 minutes. Please wait and do not force-close the window.
Q: I downloaded a .zip file — where is the .exe?
GitHub wraps artifacts in .zip. Unzip it and the .exe installer is inside.
Q: How do I uninstall? Control Panel → Programs → Uninstall a program → CP2K → Uninstall. All files are removed automatically.
To build from source (e.g. to update the CP2K version):
- Fork this repository
- Go to Actions → Build CP2K Windows Installer
- Click Run workflow on the right
- Wait for the workflow to finish (it now compiles CP2K 2026.1 from source inside WSL); download the result from the Artifacts section
Completely free — GitHub provides 2,000 free build minutes per month.
cp2k-windows-installer/
├── .github/workflows/
│ └── build.yml # Automated build pipeline (GitHub Actions)
│ # Uses Ubuntu 24.04 WSL2 + source-built CP2K 2026.1
├── installer/
│ ├── cp2k_setup.iss # Inno Setup installer script (bilingual EN/ZH)
│ └── cp2k.ico # Application icon (multi-resolution)
├── scripts/
│ ├── cp2k_shell.bat # CP2K shell launcher (tries Windows home, falls back to Linux home)
│ ├── run_cp2k.bat # Command-line calculation runner
└── README.md
This project is licensed under the MIT License — see the LICENSE file for details.
CP2K itself is licensed under the GPL-2.0 License.
CP2K 是一款用于量子化学和固体物理计算的专业科学软件。 本项目将 CP2K 2026.1（最新版）打包为 Windows 一键安装程序，无需任何技术背景，双击即可完成安装。
基于 Ubuntu 24.04 WSL2 + CP2K 2026.1 源码构建。
- 点击页面顶部的 Actions 标签
- 点击最新一条带绿色勾的记录
- 拉到页面底部，点击 Artifacts 下的
CP2K-Windows-installer下载 - 解压
.zip文件，得到CP2K_2026.1_Windows_Setup.exe - 右键 → 以管理员身份运行，按提示完成安装
💡 安装程序约 1-2 GB，安装过程需要 3-5 分钟，请耐心等待。
本安装包在单台 Windows 电脑的 WSL2中运行 CP2K，适合学习和测试，不适用于大规模生产计算。
| 场景 | 是否适合 |
|---|---|
| 学习入门 | ✅ 非常适合 |
| 输入文件调试 | ✅ 非常适合 |
| 小体系单点/优化 | ✅ 适合 |
| 短时间 AIMD | ✅ 勉强适合 |
| 大体系计算 | ❌ 不适合 |
| 多节点并行 | ❌ 不可用 |
| GPU 加速计算 | ❌ 不推荐 |
| 长时间生产计算 | ❌ 不稳定 |
本地 WSL2（本安装包） 远程 Linux 服务器
| |
写输入文件 大规模计算
小体系测试 多节点并行
参数调试 长时间任务
结果分析 GPU 加速
| |
└────────── 确认无误后提交 ────────────┘
最佳实践： 把 WSL2 + 本地 CP2K 环境定位成开发和测试环境，而不是生产计算环境，是最合理的使用方式。
安装程序会尽量全程引导。若 WSL 组件更新失败，安装器会明确提示你先手动修复，再继续安装。内置的检查和提示包括：
-
安装前自动检查
- Windows 版本是否满足要求（需 Win10 2004 或更高）
- C 盘是否有足够空间（至少 6GB）
- WSL2 是否已启用（未启用会自动帮你开启；若全部成功会提示重启继续）
-
安装中实时进度
- 步骤 1/3：导入 CP2K 运行环境（约 2-4 分钟）
- 步骤 2/3：配置系统环境变量
- 步骤 3/3：清理临时文件
-
安装失败时
- 尽量区分是 Windows 功能启用失败、WSL2 尚未就绪，还是导入运行环境失败
- 如果
wsl.exe --update失败，会提示先手动修复 WSL 更新，再重新运行安装程序
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10（2004 版本及以上）或 Windows 11 |
| 内存 | 4GB 及以上 |
| 硬盘空间 | C 盘至少 6GB 可用空间 |
| 其他 | CPU 需支持虚拟化（绝大多数现代电脑默认支持） |
不确定 Windows 版本？按
Win + R，输入winver回车查看。
安装完成后，桌面会出现 CP2K 快捷方式。
运行计算：
- 双击桌面 CP2K 图标，打开命令行后输入：
Shell 会优先定位到你的 Windows 用户主目录（
cp2k -i 你的文件.inpC:\Users\用户名）；如果该路径在 WSL 中无法解析，则会回退到 Linux 用户主目录。
Q：安装时提示"需要启用虚拟化"？
重启电脑，开机按 Del 或 F2 进入 BIOS，找到 Virtualization Technology，改为 Enabled 保存重启。
Q：安装器提示已启用 WSL2，但重启后仍然导入失败？
请先确认 Windows 已经真正完成重启，并且可选功能修改已应用完成。如果你使用的是 Windows 10，还可能需要手动安装 WSL2 Linux 内核更新包：https://aka.ms/wsl2kernel
Q：杀毒软件报警怎么办？ 安装前临时关闭杀毒软件的实时防护，安装完成后再开启。WSL2 的导入操作有时会被误报。
Q：安装卡在"导入运行环境"很久？ 正常现象，这一步需要 2-4 分钟，请耐心等待，不要强行关闭。
Q：下载的是 .zip 文件？
正常的，GitHub 会自动打包成 .zip。解压后里面就是 .exe 安装包。
Q：如何卸载？ 控制面板 → 程序 → 卸载程序 → 找到 CP2K → 卸载，会自动清理所有文件。
如需自己构建（例如更新 CP2K 版本），操作如下：
- Fork 本仓库
- 进入 Actions → Build CP2K Windows Installer / 打包 CP2K Windows 安装程序
- 点击右侧 Run workflow
- 等待工作流完成（现在会在 WSL 内源码编译 CP2K 2026.1），完成后在 Artifacts 区域下载
全程免费，GitHub 每月提供 2000 分钟免费构建时间。
cp2k-windows-installer/
├── .github/workflows/
│ └── build.yml # 自动打包流程（GitHub Actions）
│ # 基于 Ubuntu 24.04 WSL2 + CP2K 2026.1 源码构建
├── installer/
│ ├── cp2k_setup.iss # Inno Setup 安装包脚本（中英双语界面）
│ └── cp2k.ico # 应用程序图标（多分辨率）
├── scripts/
│ ├── cp2k_shell.bat # CP2K 命令行启动脚本（优先进入 Windows 主目录，失败回退到 Linux 主目录）
│ ├── run_cp2k.bat # 命令行计算运行脚本
└── README.md
本项目基于 MIT 许可证 开源，详见 LICENSE 文件。
CP2K 本体采用 GPL-2.0 许可证。