Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
February 7, 2023 08:51
March 2, 2023 15:46
March 3, 2022 14:15

License Maintenance Workflow GitHub issues GitHub contributors tensorflow GitHub release PyPI version versions

GitHub Logo

STOUT V2.0 - Smiles TO iUpac Translator Version 2.0

This repository contains STOUT-V2, SMILES to IUPAC name translator using transformers. STOUT-V2 can translate SMILES to IUPAC names and IUPAC names back to a valid SMILES string. STOUT-V1 is already published and for more details check here

OS-Support: Linux, MACOS and Windows (On Windows you can run STOUT inside the Ubuntu shell). But It is highly recommended to use a Linux system.


We suggest to use STOUT inside a Conda environment, which makes the dependencies to install easily.

  • Conda can be downloaded as part of the Anaconda or the Miniconda plattforms (Python 3.7). We recommend to install miniconda3. Using Linux you can get it with:
$ wget
$ bash

How to install STOUT

Install directly using PyPi

pip install STOUT-pypi

In a conda environment

conda create --name STOUT python=3.8 
conda activate STOUT
conda install -c decimer stout-pypi

Straight from the repository

pip install git+

Simple usage

from STOUT import translate_forward, translate_reverse

# SMILES to IUPAC name translation

IUPAC_name = translate_forward(SMILES)
print("IUPAC name of "+SMILES+" is: "+IUPAC_name)

# IUPAC name to SMILES translation

IUPAC_name = "1,3,7-trimethylpurine-2,6-dione"
SMILES = translate_reverse(IUPAC_name)
print("SMILES of "+IUPAC_name+" is: "+SMILES)

Happy Brewing... 🍺

How to cite us?

Rajan, K., Zielesny, A. & Steinbeck, C. STOUT: SMILES to IUPAC names using neural machine translation. J Cheminform 13, 34 (2021).


  • Research supported with Cloud TPUs from Google's TPU Research Cloud (TRC)

STOUT-V2 is part of DECIMER project

GitHub Logo

More about Us

GitHub Logo