CLI Basics for Reliafy Users

This page is for users who are new to command-line tools.

Prerequisites

You need Python installed and a working terminal. An IDE is optional but recommended for editing problem files, especially if you are new to Python. If you are starting from scratch, see the Getting Started with Python in VS Code guide.

What Is a CLI?

A command-line interface (CLI) lets you run software by typing commands in a terminal.

For Reliafy, the typical pattern is:

reliafy <command> <profile> [options]

Example:

reliafy analyze default --include-sorm --plot-rfad

Why Reliafy Uses a CLI

Reduced need for custom scripting in routine workflows
Reproducible workflows for coursework and research
Easy automation for repeated studies

First-Run Checklist

Install Reliafy:
```
pip install reliafy
```
Confirm the CLI is available:
```
reliafy --help
```
Copy packaged example problems:
```
reliafy examples cp
```
Run a first analysis and select one of the example problems from the file picker:
```
reliafy analyze default --include-sorm --plot-rfad
```

Understanding Outputs

Reliafy saves run outputs under timestamped folders in results/.

See Result Files for path and filename patterns.

Useful Help Commands

reliafy --help
reliafy analyze --help
reliafy design --help
reliafy simulate --help
reliafy profile --help

Common Beginner Tips

Use cd <folder> to move into your project directory before running commands.
Start with packaged examples before editing your own problem modules.
If a command fails, run reliafy --help or <command> --help and verify the options you entered.