csauto documentation

csauto automates code_saturne and code_aster simulation campaigns: it generates cases from a parameter table and a template, runs them locally or on Slurm, and follows them in a dashboard.

The VS Code extension is the primary interface and embeds the dashboard in your editor, also over Remote-SSH on HPC clusters. The CLI is the companion for headless machines and scripts, and csauto serve shows the same dashboard in a browser.

Where to start

• New here? Read Core concepts, then follow the Quickstart.
• Using VS Code? The extension guide covers install, New Campaign, the Campaigns view and settings.
• Looking something up? See Configuration, the DOE format, the CLI reference and the HTTP API.
• Something broke? Troubleshooting lists error messages and fixes.
• Adding a solver? Adding a solver explains the adapter class.

Install in one minute

In VS Code, install csauto from the Marketplace (or run code --install-extension simvia.csauto), then click the csauto icon and choose New Campaign….

Without VS Code:

Code
bash -c "$(curl -fsSL https://raw.githubusercontent.com/simvia-tech/csauto/main/install.sh)"

Python 3.11+ is required in both cases.