HPC Forge is a powerful, lightweight CLI toolkit designed to simplify everyday tasks for developers, researchers, and students working in High-Performance Computing (HPC) environments.
It helps you generate optimized Makefiles, create SLURM job scripts, and apply pre-configured templates for clusters like Deucalion, SeARCH, or your own local HPC setup — all interactively, from the terminal.
| Feature | Description |
|---|---|
| 🧱 Makefile Generator | Interactive creation of Makefiles with auto-optimized compiler flags for gcc, clang, and scorep |
| 🧩 SLURM Job Script Generator | Quickly build .slurm job scripts with dynamic runtime estimates |
| 🌌 Deucalion Mode | Instantly load tuned parameters for the Deucalion cluster (fully editable) |
| 📂 Template Viewer | Browse, preview, or apply built-in templates with syntax highlighting |
| ⚙️ Interactive Menu System | Clean, arrow-key-driven interface powered by questionary |
| 🧠 Smart Defaults | Context-aware recommendations and examples for each field |
| 🧰 Extensible Design | Modular architecture for future commands like doctor, deploy, or benchmark |
| 🛠 Roadmap | Continuous improvement toward a full HPC automation toolkit |
pip install hpcforge-cli
hpcforgegit clone https://github.com/diogocsilva12/hpcforge.git
cd hpcforge
pip install -e .
hpcforgeRun the main CLI menu:
hpcforgehpcforge make
hpcforge slurm
hpcforge slurmContributions are welcome!
- Fork the repository
- Create a new branch (
git checkout -b feature/new-feature) - Commit your changes (
git commit -m 'Add new feature') - Push to the branch (
git push origin feature/new-feature) - Open a Pull Request
MIT License. See LICENSE file for details.
- Repository: github.com/diogocsilva12/hpcforge
- Changelog: See
CHANGELOG.mdfor detailed version history and upcoming features. - PyPI Package: pypi.org/project/hpcforge-cli
- Issues & Discussions: github.com/diogocsilva12/hpcforge/issues