Metadata-Version: 2.1
Name: quacc
Version: 0.0.1
Summary: Enhance ASE for high-throughput DFT
Home-page: https://github.com/arosen93/quacc
Author: Andrew S. Rosen
Author-email: asrosen93@gmail.com
License: modified BSD
Keywords: high-throughput automated workflow dft vasp
Platform: UNKNOWN
Requires-Python: >=3.10.0
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: ase (>=3.22.1)
Requires-Dist: pymatgen (==2022.2.7)
Requires-Dist: custodian (==2022.1.17)
Requires-Dist: jobflow (==0.1.6)
Requires-Dist: atomate2 (==0.0.6)
Requires-Dist: monty (==2022.1.19)
Requires-Dist: FireWorks (==2.0.2)
Requires-Dist: cclib (==1.7.1)
Provides-Extra: dev
Requires-Dist: pytest (==7.0.0) ; extra == 'dev'
Requires-Dist: black (==22.1.0) ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx (==4.4.0) ; extra == 'docs'
Requires-Dist: numpydoc (==1.2) ; extra == 'docs'
Requires-Dist: m2r2 (==0.3.2) ; extra == 'docs'
Requires-Dist: mistune (==2.0.2) ; extra == 'docs'
Requires-Dist: pydata-sphinx-theme (==0.8.0) ; extra == 'docs'
Requires-Dist: sphinx-panels (==0.6.0) ; extra == 'docs'
Provides-Extra: tests
Requires-Dist: pytest (==7.0.0) ; extra == 'tests'

# QuAcc (ðŸš§ Under Construction ðŸš§)
![example workflow](https://github.com/arosen93/quacc/actions/workflows/workflow.yaml/badge.svg)
[![codecov](https://codecov.io/gh/arosen93/quacc/branch/main/graph/badge.svg?token=BCKGTD89H0)](https://codecov.io/gh/arosen93/quacc)
[![CodeFactor](https://www.codefactor.io/repository/github/arosen93/quacc/badge)](https://www.codefactor.io/repository/github/arosen93/quacc)
[![This project supports Python 3.10](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org/downloads)

The Quantum Accelerator (QuAcc) supercharges your code to support high-throughput, database-driven density functional theory (DFT). Primarily, QuAcc seeks to enable a seamless interface between the [Atomic Simulation Environment](https://wiki.fysik.dtu.dk/ase/index.html) (ASE) and [Jobflow](https://github.com/materialsproject/jobflow) for rapid workflow development and prototyping, no matter your favorite DFT package.

This package is heavily inspired by [Atomate2](https://github.com/materialsproject/atomate2), which I also recommend checking out.

## Installation
1. Run the following command, ideally in a fresh Python environment: `pip install quacc`. For the most recent development version, instead run `pip install git+https://github.com/arosen93/quacc.git`.

2. Follow the instructions in ASE's [documentation](https://wiki.fysik.dtu.dk/ase/ase/calculators/calculators.html#supported-calculators) for how to set up the ASE calculator(s) you plan to use.

3. Define the following environment variables (e.g. in your `~/.bashrc`) if you wish to use Jobflow and/or Fireworks, in addition to any that you have set in Step 2. Example `.yaml` files are provided [here](https://github.com/arosen93/quacc/tree/main/examples/config).

```bash
# Jobflow requirements
# (details: https://materialsproject.github.io/jobflow/jobflow.settings.html)
export JOBFLOW_CONFIG_FILE="/path/to/config/jobflow_config/jobflow.yaml"

# FireWorks requirements
# (details: https://materialsproject.github.io/fireworks)
export FW_CONFIG_FILE='/path/to/config/fw_config/FW_config.yaml'

```
## License
QuAcc is released under a [modified BSD license](https://github.com/arosen93/quacc/blob/main/LICENSE.md).


