\section{Installation}

There are three ways to run \mcf:
%
\begin{inparaenum}
\item You can use the web interface.
\item You can install a web client version of \mcf that is operated from the command line.
\item You can install the entire program locally.
\end{inparaenum}

With options 1 and 2, everything you need can hopefully be installed via TeXLive by the time you read this. In contrast, with option 3, some additional handiwork is required.

Update: \mcf has been on CTAN for a good while now, but as far as I can tell adoption into TeXLive has not happened, and apparently isn't going to. 

\subsection{\LaTeX\ requirements}

In order to use the code generated by \mcf in your documents, you need

\begin{enumerate}
\item \tkz, a large and powerful general graphics package.

\item \chf, which defines the code format used by \mcf and uses \tkz to render it to molecule graphics.

\item The \texttt{mol2chemfig.sty} package. This is a very small package that  defines some auxiliary macros for \mcf.
\end{enumerate}

\tkz and \chf are available through TeXLive, and \mcf is or will hopefully soon be, too. Note that the \mcf package will load the \chf package for you, which in turn loads \tkz. Therefore, in your documents, it is sufficient to include the clause \lstinline!\usepackage{mol2chemfig}! in order to load all three of them.

\subsection{Installing the Lua web client}

The web client should be installed and properly configured when you install \mcf through TeXLive; this is the preferred method. You should be able to invoke it from a shell window (or command prompt, in Windows parlance) with the command

\begin{lstlisting}
$ mol2chemfig.lua
\end{lstlisting}

If you downloaded the \mcf bundle from CTAN, no automatic installation is performed. In that case, follow the instructions in the included README file.

\subsection{Local installation}

For the full local install of \mcf, you need a Python base installation, and additionally the \texttt{indigo} cheminformatics toolkit. On at least some Linux distributions, \texttt{indigo} is available through the package manager. On other systems, manual download (\url{http://ggasoftware.com/download/indigo}) and installation may be required.

Once you have the prerequisites installed and working, download the \mcf Python code from \url{http://chimpsky.uwaterloo.ca/mol2chemfig}, unzip in a convenient location and follow the included instructions.
