# batchRun

**Repository Path**: ByteDance/batchRun

## Basic Information

- **Project Name**: batchRun
- **Description**: batchRun is an ansible-similar IT automation system, which is more suitable for IC industry.
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 1
- **Created**: 2023-01-16
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: nms

**Tags**: None

## README

**Version:** V2.5


## What's batchRun?
batchRun is a batch opration, asset management, and information collection tool applied to HPC systems.
You can run batchRun with command line or GUI mode.


## Python dependency
Need python3.12.12
Install python library dependency with command

    pip install -r requirements.txt


## Install
Copy install package into install directory.
Execute below command under install directory.

    python3 install.py


## Quick start
Execute command `batch_run --help` to get usage information.
Execute command `batch_run --gui` to enable GUI mode.
* Below is a demo on how to run command with command line.

   ![command_line_run_demo](data/demo/command_line_run_demo.gif)

* Below is a demo on how to run command with GUI.

   ![gui_run_demo](data/demo/gui_run_demo.gif)

* Below is a demo on how to view host info with GUI.

   ![host_filter_demo](data/demo/gui_info_demo.gif)


## Configuration
Come into <BATCH_RUN_INSTALL_PATH>/config directory,

  - Update "config.py" for batchRun basic configuration.
  - Update "host.list" for group-host relationship.
  - Use "tools/save_password" to save encrypted user/password information if necessary.


## Sample
Collect host information with tool "sample_host_info".


## Doc
More details please see ["docs/batchRun_user_manual.md"](./docs/batchRun_user_manual.md)


## Update history
***
| Version | Date      | Update content                             |
|:--------|:----------|:-------------------------------------------|
| V1.0    | (2022.12) | Release original version.                  |
| V1.1    | (2023.07) | Support host_ip & host_name multi-mapping. |
|         |           | Remove LSF supporting.                     |
| V1.2    | (2024.08) | Add host info sampling function.           |
| V2.0    | (2024.10) | Add GUI with GROUP/HOST/RUN/LOG tabs.      |
| V2.1    | (2025.01) | Add SCAN tab on GUI.                       |
|         |           | Add STAT tab on GUI.                       |
|         |           | Add scheduler/cluster/queue on GROUP tab.  |
|         |           | Fix the id authentication bug on crontab.  |
| V2.2    | (2025.02) | Merge GROUP&HOST tabs on GUI.              |
|         |           | Add ASSET tab on GUI.                      |
| V2.3    | (2025.12) | Add stat curve function on STAT tab.       |
| V2.4    | (2026.06) | Add AI menu: assistant, cluster analysis,  |
|         |           | security analysis.                         |
| V2.5    | (2026.08) | Security hardening: Fernet password store  |
|         |           | with separate master key; path-traversal   |
|         |           | protection on the embedded web server; AST |
|         |           | safe expression evaluator; SQL identifier   |
|         |           | validation; non-blocking GUI tool threads;  |
|         |           | password redaction in command history;     |
|         |           | `-P 0` disallowed (use [1, max_parallel]); |
|         |           | sample tools pass password via env var.    |