Metadata-Version: 2.4
Name: moldenViz
Version: 1.2.0
Project-URL: Documentation, https://moldenviz.readthedocs.io/en/latest/
Project-URL: Issues, https://github.com/Faria22/moldenViz/issues
Project-URL: Source, https://github.com/Faria22/moldenViz
Author-email: Faria22 <fariafelipe22@hotmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Requires-Dist: numpy>=1.20
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydata-sphinx-theme>=0.14
Requires-Dist: pyside6
Requires-Dist: pyvista>=0.44
Requires-Dist: pyvistaqt>=0.10
Requires-Dist: scipy>=1.7
Requires-Dist: sphinx>=7.0
Requires-Dist: toml
Description-Content-Type: text/markdown

# moldenViz

[![PyPI - Version](https://img.shields.io/pypi/v/moldenviz.svg)](https://pypi.org/project/moldenviz)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/moldenviz.svg)](https://pypi.org/project/moldenviz)
[![Documentation Status](https://readthedocs.org/projects/moldenviz/badge/?version=latest)](https://moldenviz.readthedocs.io/en/latest/?badge=latest)

-----

## Installation

```console
pip install moldenViz
```

``moldenViz`` uses ``tkinter`` for its GUI. If ``python3 -m tkinter`` fails, install the tkinter package provided by your operating system (``brew install python-tk`` on macOS, ``sudo apt-get install python3-tk`` on Ubuntu).

## Quick start

- Launch the viewer with an example molecule:

  ```console
  moldenViz -e benzene
  ```

- Use the Python API for scripted workflows:

  ```python
  from moldenViz import Plotter
  Plotter('my.molden')
  ```

Full CLI usage, configuration examples, and API walkthroughs live in the docs.

## Documentation

Latest docs: https://moldenviz.readthedocs.io/en/latest/

## Roadmap

Major milestones and planned features are tracked in the [Roadmap](https://moldenviz.readthedocs.io/en/latest/roadmap.html). Highlights:

- ✅ v1.1 – VTK/cube export, expanded CLI reference, richer docs.
- ▶️ v2.0 – cartesian basis support

## Contributing

Guidelines for reporting issues, running tests, and building docs are in the [Contributing guide](https://moldenviz.readthedocs.io/en/latest/contributing.html).
