Metadata-Version: 2.1
Name: SumsJob
Version: 0.1.1
Summary: A simple Linux command-line utility which submits a job to one of the multiple servers
Home-page: https://github.com/lululxvi/sumsjob
Author: Lu Lu
Author-email: lululxvi@gmail.com
License: GPL-3.0
Download-URL: https://github.com/lululxvi/deepxde/tarball/v0.1.1
Description: # &Sigma;&Sigma;<sub>Job</sub>
        
        [![PyPI version](https://badge.fury.io/py/SumsJob.svg)](https://badge.fury.io/py/SumsJob)
        [![License](https://img.shields.io/github/license/lululxvi/sumsjob)](https://github.com/lululxvi/sumsjob/blob/master/LICENSE)
        
        &Sigma;&Sigma;<sub>Job</sub> or Sums<sub>Job</sub> (**S**imple **U**tility for **M**ultiple-**S**ervers **Job** **Sub**mission) is a simple Linux command-line utility which submits a job to one of the multiple servers each with limited resources. It will first look for servers with available resources, such as GPUs, and then run the job in that server interactively just as the job is running in your local machine.
        
        **Tutorial**: [Slides](https://github.com/lululxvi/sumsjob/blob/master/tutorials/sumsjob.pdf)
        
        ## Features
        
        - Simple to use: one single `submit` command is all your need
        - Automatically choose available GPUs among all the servers
        - Display the output of the job in real time
        - Kill the job by Ctrl-C
        - Save the output in a log file
        - Transfer back the files you specified
        
        ## Usage
        
        ### `$ gpuresource`
        
        Show the status of GPUs on all servers.
        
        ### `$ submit jobfile jobname`
        
        - `jobfile` : File to be run
        - `jobname` : Job name, and also the folder name of the job. If not provided, a random number will be used.
        
        Options:
        
        - `-h`, `--help` : Show this help message and exit
        - `-s SERVER`, `--server SERVER` : Server host name
        - `--gpuid GPUID` : GPU ID to be used; -1 to use CPU only
        
        ## Installation
        
        Install [gpustat](https://github.com/wookayin/gpustat) in each server.
        
        Then, you can install Sums<sub>Job</sub> with `pip`:
        
        ```
        $ pip install sumsjob
        ```
        
        You need to have a configuration file at `~/.sumsjob/config.py`. Use [config.py](https://github.com/lululxvi/sumsjob/blob/master/sumsjob/config.py) as a template, and modify the values to your configurations.
        
        - Make sure you can `ssh` to each server.
        - Run `gpuresource` to check if everything works. Make sure `~/.local/bin` is in your `$PATH`.
        
        ## License
        
        [GNU GPLv3](LICENSE)
        
Keywords: Command-line utility,Multiple servers,GPU,Job submission
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
