Introduction to asymptote

Asymptote is a powerful descriptive vector graphics language that provides a natural coordinate-based framework for technical drawing. Labels and equations can be typeset with LaTeX. As well as EPS, PDF and PNG output it can produce WebGL 3D HTML rendering and (using dvisvgm) SVG output.

This package is known to build and work properly using an LFS 12.1 platform.

Package Information

Additional Downloads

asymptote Dependencies


ghostscript-10.02.1 and texlive-20230313



fftw-3.3.10, Gsl-2.7.1, libsigsegv-2.14, both Boost-1.84.0 and rapidjson to use LSP which can be used with emacs, and eigen

Optional (at runtime)

ImageMagick-7.1.1-28 to convert output to other formats such as JPEG or to create animated GIFs, PyQt5 (not tested, has a build dependency of (Qt-5.15.12 or qt-alternate-5.15.12)) to use xasy.

Editor Notes:

Installation of asymptote



Certain 3D PDF scripts may not work when invoked from pdflatex on some zen+ amdgpu APU machines.

First apply a patch to fix building without the Language Server Protocol :

patch -Np1 -i ../asymptote-2.86-build_fix-1.patch

Install asymptote by running the following commands:

export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &&

./configure --prefix=$TEXLIVE_PREFIX                          \
            --bindir=$TEXLIVE_PREFIX/bin/$TEXARCH             \
            --datarootdir=$TEXLIVE_PREFIX/texmf-dist          \
            --infodir=$TEXLIVE_PREFIX/texmf-dist/doc/info     \
            --libdir=$TEXLIVE_PREFIX/texmf-dist               \
            --mandir=$TEXLIVE_PREFIX/texmf-dist/doc/man       \
            --disable-lsp                                     \
            --enable-gc=system                                \
            --with-latex=$TEXLIVE_PREFIX/texmf-dist/tex/latex \
            --with-context=$TEXLIVE_PREFIX/texmf-dist/tex/context/third &&


To test the results, issue: make check.

Now, as the root user:

make install

Command Explanations

--prefix=, --bindir=, --datarootdir=, and other dir switches: these switches ensure that the files installed from source will overwrite any corresponding files previously installed by install-tl-unx so that the alternative methods of installing texlive are consistent.

--libdir=$TEXLIVE_PREFIX/texmf-dist: This parameter ensures that the asymptote directory will similarly overwrite any files installed by install-tl-unx.

--disable-lsp: The Language Server Protocol is enabled by default, with several third-party sources included, but it does not build unless boost and repidjson have been installed.

--enable-gc=system: this ensures that the system version of will be used instead of the version shipped with this package.

--with-latex= --with-context=: These switches ensure that style files and a tex file will be installed into the texlive directories instead of creating a texmf-local directory for them.


Installed Programs: asy, xasy
Installed Libraries: None
Installed Directory: $TEXLIVE_PREFIX/texmf-dist/asymptote, $TEXLIVE_PREFIX/doc/asymptote, $TEXLIVE_PREFIX/info/asymptote

Short Descriptions


is a vector graphics program


is a Python3 script providing a Qt5 GUI for asy