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