Installation

TENSO is a Python package. Installation uses Anaconda for environment management and pip for the package itself. A dedicated conda virtual environment is strongly recommended to isolate TENSO's dependencies.

TENSO is supported on Linux, macOS, and Windows. Select your operating system:

1. Install Anaconda

Download Anaconda from anaconda.com/download. Then open a terminal in your Downloads folder and run:

bash ./Anaconda3-*.sh

Follow the prompts and restart your terminal when the installation completes.

2. Create and activate a conda environment

conda create --name tenso python=3 matplotlib
conda activate tenso

3. Install TENSO

Install git if not already present. You can install it via your distribution's package manager or through conda:

# via conda (works on any distro, no sudo required)
conda install git

# or via apt on Debian/Ubuntu
# sudo apt install git

Clone the repository and install in editable mode:

git clone https://github.com/ifgroup/pytenso.git
mv pytenso ~/
cd ~/pytenso
python -m pip install -e .

1. Install Anaconda

Download the macOS installer from anaconda.com/download. Open the .pkg file and follow the graphical installer.

If you prefer the command-line installer, open Terminal and run:

bash ~/Downloads/Anaconda3-*.sh

2. Create and activate a conda environment

conda create --name tenso python=3 matplotlib
conda activate tenso

3. Install TENSO

git is bundled with Xcode Command Line Tools. Install if not present:

xcode-select --install

Then clone the repository and install:

git clone https://github.com/ifgroup/pytenso.git
mv pytenso ~/
cd ~/pytenso
python -m pip install -e .

1. Install Anaconda

Download the Windows installer from anaconda.com/download. Run the .exe file and follow the graphical installer. When asked, check "Add Anaconda to my PATH environment variable" or use the Anaconda Prompt for all subsequent steps.

2. Create and activate a conda environment

Open Anaconda Prompt and run:

conda create --name tenso python=3 matplotlib
conda activate tenso

3. Install Git for Windows

Download and install Git from git-scm.com/download/win. During installation, select "Git from the command line and also from 3rd-party software".

4. Install TENSO

In Anaconda Prompt, clone the repository and install:

git clone https://github.com/ifgroup/pytenso.git
cd pytenso
python -m pip install -e .

Verifying the installation

After installing, confirm that TENSO is importable:

python -c "import tenso; print('TENSO installed successfully')"

For interactive use, consider also installing JupyterLab:

pip install jupyterlab
ENJOY your Numerically Exact Open Quantum Dynamics Simulations!
Getting Started Background