# Installation

## VFTools

The VFTools package can be installed anywhere on the system. This can be done by going to the desired installation directory, and then by downloading the archive from the GitHub repository:

```
wget https://github.com/VirtualFlow/VFTools/archive/master.tar.gz
```

Afterward, it can be extracted:

```
tar -xvzf master.tar.gz
mv VFTools-master VFTools
```

The executable files of VFTools are located in the folder `VFTools/bin/`

To make these commands more conveniently available, one can include the directory into the Linux PATH variable:&#x20;

```
export PATH="<parent folder>/VFTools/bin:$PATH"
```

where `<parent folder>` is the folder in which the VFTools folder is located. To make the above change of the PATH variable permanent (enduring restarts) and global (available in any newly started terminal), it can be placed at the end of the `~/.bashrc` file in the home directory.

## OpenBabel

VFLP requires OpenBabel to be installed, as it uses the command obabel command of this package.&#x20;

OpenBabel can be installed locally in the home directory, or by system admins globally, or might be available as a module on the computer cluster. This information can be found often on the website of the computer cluster. If it is not installed, then contacting the admins of the cluster often is the way to go forward, since it is usually quite simple for them to install the package on the cluster.

The critical thing is that the `obabel` command is in the PATH and thus executable from anywhere.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.virtual-flow.org/documentation-vf1/vftools/installation-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
