logomaker-viewer 0.1.0

Browser-based GUI for the logomaker sequence logo package

LogoMaker Viewer

A browser-based GUI for the logomaker Python package.
Upload a multiple sequence alignment (FASTA, GenBank, Clustal, Stockholm) and interactively generate publication-quality sequence logos — no command line required.

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

pip install logomaker-viewer

Or into a fresh conda environment:

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

Usage

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

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 (Tareen & Kinney, 2020).

License

MIT