About this project
fishell is a command-line utility, written in Bash and PowerShell, that simplifies SSH access to the NPAD/UFRN (IMD) supercomputer. It configures RSA keys, registers the npad alias in ~/.ssh/config, and offers an interactive panel in Portuguese or English for login, connection testing, sending and downloading via scp, executing remote commands, and new keygen.
On Windows, it uses a .cmd launcher for PowerShell; on Linux, macOS, WSL, and Google Colab, it runs via Bash. The README details installation, panel usage, commands, Slurm workflow (sbatch, squeue, scancel), partitions, GPU jobs, troubleshooting, structure, and security. MIT License.
The panel is triggered by keys: 1 opens the shell on NPAD, 2 tests the connection, 3 sends a file/folder via scp, 4 downloads a file/folder via scp, 5 runs a command on NPAD and shows the output, 6 redos the SSH setup, 7 shows the current configuration, 8 generates a new key pair, l changes the interface language, a toggles the banner animation, and 0 or q exits.
Command-line options include: interactive panel, setup, login, test, upload, download, run "command", keygen, status, and help. After setup, the alias remains in ~/.ssh/config and normal SSH works from any terminal, without fishell, with examples such as ssh npad, scp dados.zip npad:~/ and scp npad:~/resultado.h5 .
The README also serves as a practical summary for using NPAD, covering the difference between the login node and compute nodes, job submission with #SBATCH scripts, partitions such as amd-512, gpu-8-v100, and gpu-4-a100, GPU usage with the conda gpu environment, queue monitoring with squeue, sinfo, and scancel, as well as common errors and their solutions. Official and complete documentation is available at npad.ufrn.br and in the NPAD Tutorials.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.