KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #react #mcp #rust

gbdraw

★ 144 Open GitHub ↗

A genome diagram generator for microbes and organelles

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Static Badge](https://img.shields.io/badge/gbdraw%20webapp-8A2BE2)](https://gbdraw.app/)
[![DOI](https://img.shields.io/badge/DOI-10.64898/2026.04.07.716863-blue)](https://doi.org/10.64898/2026.04.07.716863)
[![Anaconda-Server Badge](https://anaconda.org/bioconda/gbdraw/badges/version.svg)](https://anaconda.org/bioconda/gbdraw)
[![Anaconda-Server Badge](https://anaconda.org/bioconda/gbdraw/badges/platforms.svg)](https://anaconda.org/bioconda/gbdraw)
[![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/gbdraw/README.html)
[![Anaconda-Server Badge](https://anaconda.org/bioconda/gbdraw/badges/latest_release_date.svg)](https://anaconda.org/bioconda/gbdraw)
[![Anaconda-Server Badge](https://anaconda.org/bioconda/gbdraw/badges/downloads.svg)](https://anaconda.org/bioconda/gbdraw)
[![Anaconda-Server Badge](https://anaconda.org/bioconda/gbdraw/badges/license.svg)](https://anaconda.org/bioconda/gbdraw)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/satoshikawato/gbdraw)

# gbdraw

![gbdraw](https://github.com/satoshikawato/gbdraw/blob/main/examples/gbdraw_social_preview.png)

`gbdraw` is a command-line and browser-based tool for publication-quality genome diagrams. It accepts GenBank/DDBJ flatfiles or GFF3 + FASTA pairs and produces circular or linear plots in SVG, PNG, PDF, EPS, or PS.

[Interactive SVG output gallery](https://gbdraw.app/gallery/)
## Features

- Circular and linear genome diagrams from annotated sequence files
- Comparative genomics tracks from BLAST outfmt 6 or 7
- Reusable coordinate- and feature-targeted annotation tracks
- Browser-based GUI at [gbdraw.app](https://gbdraw.app/) and local GUI via `gbdraw gui`
- Fine-grained control over colors, labels, legends, and track layout
- Export to SVG, PNG, PDF, EPS, and PS (PNG, PDF, EPS, and PS require CairoSVG)

## Documentation

| Route | Use it for |
| --- | --- |
| [Tutorials](./docs/TUTORIALS/README.md) | Build complete, reproducible figures in the web app, on the command line, or from Python. |
| [Technical documentation](./docs/REFERENCE/README.md) | Look up controls, options, schemas, APIs, compatibility, outputs, and source provenance. |
| [FAQ](./docs/FAQ.md) | Choose a layout, interface, or comparison method and resolve common problems. |
| [Gallery](./docs/GALLERY.md) | Inspect finished static and interactive figures before choosing a workflow. |

The [documentation home](./docs/DOCS.md) links the four routes above. Supporting
pages cover [installation](./docs/INSTALL.md), [tutorial
inputs](./docs/GETTING_TUTORIAL_DATA.md), [citation and project
background](./docs/ABOUT.md), and the [changelog](./CHANGELOG.md).
See [Contributing](./CONTRIBUTING.md) to report a bug, set up a development
environment, or submit a pull request.

## Use without local installation

The hosted web app runs entirely in your browser:

[https://gbdraw.app/](https://gbdraw.app/)

Uploaded genomic data stays on your machine. The hosted site uses Google Analytics 4 for aggregate page-usage metrics; gbdraw does not send uploaded genome files or generated diagrams to Google Analytics.

## Local installation

For regular use, Bioconda is the main installation path:

```bash
mamba create -n gbdraw -c conda-forge -c bioconda gbdraw
conda activate gbdraw
gbdraw -h
gbdraw gui
```

For development from source:

```bash
git clone https://github.com/satoshikawato/gbdraw.git
cd gbdraw
python -m pip install -e ".[dev]"
```

If you need PNG/PDF/EPS/PS export from a source install, add the optional export dependency:

```bash
python -m pip install -e ".[dev,export]"
```

See [Installation](./docs/INSTALL.md) for details and platform notes.

## Bug reports and suggestions

Please open an issue if you find a bug or want to propose an improvement:

https://github.com/satoshikawato/gbdraw/issues

## How to cite

If you use `gbdraw` in your research, please cite the preprint:

```text
Kawato, S. (2026). gbdraw: a genome diagram generator for microbes and organelles. bioRxiv. https://doi.org/10.64898/2026.04.07.716863
```

gbdraw

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README