Installing XOA Chimera Core

XOA Chimera Core is available to install via the Python Package Index. You can also install from the source file.

Prerequisites

Before installing XOA Chimera Core, please make sure your environment has installed:

• Python

• pip

Python

XOA Chimera Core requires that you install Python on your system.

Note

XOA Chimera Core requires Python >= 3.8.

pip

Make sure pip is installed on your system. pip is the package installer for Python . You can use it to install packages from the Python Package Index and other indexes.

Usually, pip is automatically installed if you are:

• working in a virtual Python environment (virtualenv or venv ). It is not necessary to use sudo pip inside a virtual Python environment.

• using Python downloaded from python.org

If you don’t have pip installed, you can:

• Download the script, from https://bootstrap.pypa.io/get-pip.py.

• Open a terminal/command prompt, cd to the folder containing the get-pip.py file and run:

Windows

Install pip in Windows environment.

> py get-pip.py

macOS/Linux

Install pip in macOS/Linux environment.

$ python3 get-pip.py

See also

Read more details about this script in pypa/get-pip.

Read more about installation of pip in pip installation.

Installing From PyPI Using pip

pip is the recommended installer for XOA Chimera Core. The most common usage of pip is to install from the Python Package Index using Requirement Specifiers.

Note

If you install XOA Chimera Core using pip install chimera-core, XOA Python API (PyPI package name xoa_driver) will be automatically installed.

Install to Global Namespace

Windows

Install XOA Chimera Core in Windows environment from PyPI.

> pip install chimera-core            # latest version
> pip install chimera-core==1.0.7     # specific version
> pip install chimera-core>=1.0.7     # minimum version

macOS/Linux

Install XOA Chimera Core in macOS/Linux environment from PyPI.

$ pip install chimera-core            # latest version
$ pip install chimera-core==1.0.7     # specific version
$ pip install chimera-core>=1.0.7     # minimum version

Install in Virtual Environment

Install XOA Chimera Core in a virtual environment, so it does not pollute your global namespace.

For example, your project folder is called /my_xoa_project.

Windows

Install XOA Chimera Core in a virtual environment in Windows from PyPI.

[my_xoa_project]> python -m venv ./env
[my_xoa_project]> source ./env/bin/activate

(env) [my_xoa_project]> pip install chimera-core         # latest version
(env) [my_xoa_project]> pip install chimera-core==1.0.7  # specific version
(env) [my_xoa_project]> pip install chimera-core>=1.0.7  # minimum version

macOS/Linux

Install XOA Chimera Core in a virtual environment in macOS/Linux from PyPI.

[my_xoa_project]$ python3 -m venv ./env
[my_xoa_project]$ source ./env/bin/activate

(env) [my_xoa_project]$ pip install chimera-core         # latest version
(env) [my_xoa_project]$ pip install chimera-core==1.0.7  # specific version
(env) [my_xoa_project]$ pip install chimera-core>=1.0.7 # minimum version

Afterwards, your project folder will be:

After creating Python virtual environment

/my_xoa_project
    |
    |- env

See also

• Virtual Python environment

• virtualenv

• venv

Upgrading From PyPI Using pip

To upgrade XOA Chimera Core package from PyPI:

Windows

Upgrade XOA Chimera Core in Windows environment from PyPI.

> pip install chimera-core --upgrade

macOS/Linux

Upgrade XOA Chimera Core in macOS/Linux environment from PyPI.

$ pip install chimera-core --upgrade

Note

If you upgrade XOA Chimera Core using pip install --upgrade chimera-core, XOA Python API (PyPI package name xoa_driver) will be automatically upgraded.

Installing Manually From Source

If for some reason you need to install XOA Chimera Core manually from source, the steps are:

Step 1, make sure Python packages wheel and setuptools are installed on your system. Install wheel and setuptools using pip:

Windows

Install wheel and setuptools in Windows environment.

> pip install wheel setuptools

macOS/Linux

Install wheel and setuptools in macOS/Linux environment.

$ pip install wheel setuptools

Step 2, download the XOA Chimera Core source distribution from XOA Chimera Core Releases. Unzip the archive and run the setup.py script to install the package:

Windows

Install XOA Chimera Core in Windows environment from source.

[xoa_core]> python setup.py install

macOS/Linux

Install XOA Chimera Core in macOS/Linux environment from source.

[xoa_core]$ python3 setup.py install

Step 3, if you want to distribute, you can build .whl file for distribution from the source:

Windows

Build XOA Chimera Core wheel in Windows environment for distribution.

[xoa_core]> python setup.py bdist_wheel

macOS/Linux

Build XOA Chimera Core wheel in macOS/Linux environment for distribution.

[xoa_core]$ python3 setup.py bdist_wheel

Important

If you install XOA Chimera Core from the source code, you need to install XOA Python API (PyPI package name xoa_driver) separately. This is because XOA Python API is treated as a 3rd-party dependency of XOA Chimera Core. You can go to XOA Python API repository to learn how to install it.

Uninstall and Remove Unused Dependencies

pip uninstall chimera-core can uninstall the package itself but not its dependencies. Leaving the package’s dependencies in your environment can later create conflicting dependencies problem.

We recommend install and use the pip-autoremove utility to remove a package plus unused dependencies.

Windows

Uninstall XOA Chimera Core in Windows environment.

> pip install pip-autoremove
> pip-autoremove chimera-core -y

macOS/Linux

Uninstall XOA Chimera Core in macOS/Linux environment.

$ pip install pip-autoremove
$ pip-autoremove chimera-core -y

See also

See the pip uninstall reference.

See pip-autoremove usage.