Skip to content
A Python script to run Gaussian automatically and in batches.
Branch: master
Clone or download
njzjz and repo-ranger chore: update GitHub Actions (#43)
* chore: update GitHub Actions

* Update tox.ini

* Update main.workflow

* Update tox.ini

* Update tox.ini

* Update tox.ini

* Update main.workflow

* Update main.workflow

* Delete .travis.yml

* Delete .whitesource

* Update
Latest commit 4f9dcf5 May 24, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: update GitHub Actions (#43) May 23, 2019
gaussianrunner fix: save analysis data (#41) May 13, 2019
.gitignore fix: try travis Feb 3, 2019
.stickler.yml Adding .stickler.yml Jan 15, 2019 fix: repeat Feb 5, 2019
tox.ini Update tox.ini Mar 3, 2019


python version PyPI Coverage Status codecov Codacy Badge

A Python script to run Gaussian automatically and in batches.

Author: Jinzhe Zeng


Research Group



Before you use GaussianRunner, please install Gaussian and OpenBabel first.

With pip

$ pip install gaussianrunner

Build from source

$ git clone
$ cd GaussianRunner/
$ pip install .

You can test whether the program is running normally:

% python pytest


Simple example

>>> from gaussianrunner import GaussianRunner,GaussianAnalyst
>>> logfiles=GaussianRunner(keywords='opt freq b3lyp/6-31g(d,p)').runGaussianInParallel('SMILES',['C','C=C','CC','CO','OCCO','C=O','CN','O=O','O'])
>>> GaussianAnalyst(properties=['free_energy']).readFromLOGs(logfiles)
[{'name': 'C.log', 'free_energy': -40.49868}, {'name': 'C=C.log', 'free_energy': -78.563562}, {'name': 'CC.log', 'free_energy': -79.786915}, {'name': 'CO.log', 'free_energy': -115.69529}, {'name': 'OCCO.log', 'free_energy': -230.198798}, {'name': 'C=O.log', 'free_energy': -114.498144}, {'name': 'CN.log', 'free_energy': -95.822381}, {'name': 'O=O.log', 'free_energy': -150.272624}, {'name': 'O.log', 'free_energy': -76.416031}]

Running across nodes with MPI

First, install MPI4PY and MPICH 2:

$ conda install mpi4py

Then run with MPI:

$ mpirun -n 9 --hostfile hostfile python

There should be hostfile in the folder.

You can’t perform that action at this time.