Metadata-Version: 2.4
Name: logomaker-viewer
Version: 0.1.0
Summary: Browser-based GUI for the logomaker sequence logo package
Author: Jake C
License: MIT
Project-URL: Homepage, https://github.com/YOUR_USERNAME/logomaker-viewer
Project-URL: Bug Tracker, https://github.com/YOUR_USERNAME/logomaker-viewer/issues
Keywords: bioinformatics,sequence logo,multiple sequence alignment,visualization
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: flask>=2.2
Requires-Dist: logomaker>=0.8
Requires-Dist: biopython>=1.79
Requires-Dist: matplotlib>=3.5
Requires-Dist: numpy>=1.22
Requires-Dist: pandas>=1.4

# LogoMaker Viewer

A browser-based GUI for the [`logomaker`](https://github.com/jbkinney/logomaker) Python package.  
Upload a multiple sequence alignment (FASTA, GenBank, Clustal, Stockholm) and interactively generate publication-quality sequence logos — no command line required.

![Sequence logo example](https://raw.githubusercontent.com/YOUR_USERNAME/logomaker-viewer/main/docs/example.png)

## Features

- **Drag-and-drop upload** — FASTA, GenBank, Clustal, Stockholm alignments
- **Click-to-recolour** — click any residue on the rendered logo to open a colour picker for that character
- **Full logomaker control** — matrix type, colour scheme, font, stack order, fade/shade, vpad, vsep, and more
- **Live character palette** — see and edit all character colours at a glance
- **Export** — download as PNG, SVG, or PDF at any DPI

## Installation

```bash
pip install logomaker-viewer
```

Or into a fresh conda environment:

```bash
conda create -n logomaker-viewer python=3.11
conda activate logomaker-viewer
pip install logomaker-viewer
```

## Usage

```bash
logomaker-viewer
```

This starts a local web server and opens `http://127.0.0.1:5000` in your browser automatically.

### Options

```
logomaker-viewer --port 8080        # use a different port
logomaker-viewer --no-browser       # don't auto-open browser
logomaker-viewer --host 0.0.0.0    # expose on local network
logomaker-viewer --debug            # Flask debug mode
```

## Supported file formats

| Format | Extensions |
|--------|-----------|
| FASTA  | `.fa`, `.fasta`, `.fna`, `.faa` |
| GenBank | `.gb`, `.gbk`, `.genbank` |
| Clustal | `.clw` |
| Stockholm | `.stk` |

All sequences in the file must be the same length (i.e. a true multiple sequence alignment).

## Development

```bash
git clone https://github.com/YOUR_USERNAME/logomaker-viewer.git
cd logomaker-viewer
pip install -e ".[dev]"
python -m logomaker_viewer.cli
```

## Credits

Sequence logos are rendered by [logomaker](https://github.com/jbkinney/logomaker) (Tareen & Kinney, 2020).

## License

MIT
