Metadata-Version: 2.4
Name: molbo
Version: 0.1.1
Summary: Inspect PDB/CIF molecular structures from the command line
Author: molbo contributors
License-Expression: MIT
Keywords: cif,cli,molbo,molecular,molstar,pdb,structure,viewer
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Chemistry
Requires-Python: >=3.10
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# Molbo

[![Support](https://img.shields.io/pypi/status/molbo?label=support&color=f3c539)](https://pypi.org/project/molbo/) [![PyPI](https://img.shields.io/pypi/v/molbo?label=pypi&color=107cb8)](https://pypi.org/project/molbo/)

<p align="center">
  <img src="docs/static/molbo-logo.png" width="50%" alt="poorly drawn molbo logo">
</p>

## Overview

`molbo` is a command-line launcher for interactive molecular structure viewing in [Mol*](https://molstar.org/). It accepts local structure files, remote structure URLs, 4-character PDB IDs, and starts a small HTTP server that serves a self-contained Mol* viewer from vendored frontend assets.

## Installation

```bash
uv tool install molbo
```

## Usage

Opening a structure is as easy as:

```bash
molbo structure.pdb
```

Read [the documentation](https://leightonpayne.github.io/molbo/) for more information on what `molbo` can do.

## License

`molbo` is released under the [MIT license](https://choosealicense.com/licenses/mit/). The package also vendors frontend assets available under the [MIT license](https://choosealicense.com/licenses/mit/). See `src/molbo/vendor/LICENSE-molstar` and `src/molbo/vendor/LICENSE-qrcode-generator` for more information.
