Initializing help system before first use

Python Developer Prerequisites

The paragraph details the conditions you must fulfill to be able to use the Insight Python module.

Users creating a Python application for Insight should have experience developing Python applications. For developing optimization models, you should have experience with an optimization package like the Xpress Optimizer Python API. The Xpress Solver Python API is documented separately here and is available through PyPI (pip) and Conda.

This guide assumes you have FICO® Xpress Insight and FICO® Xpress Workbench installed locally.
You should also:
  • Be familiar with Python (at least able to read simple models.)
  • Be familiar with HTML and XML. View Definition Language (VDL) is largely composed of a set of HTML extensions.
  • Have some experience of programming and the usual edit-compile-run development cycles.

More advanced use of Xpress Insight will benefit from a good knowledge of JavaScript, and further experience with Python.

Overview

The interaction between Xpress Insight and Python and how the data model is presented to the end user, can be customized using the FICO® Xpress Insight View Definition Language (VDL). The FICO® Xpress Workbench development environment comes with the View Designer, a code-free, pure drag and drop capable, wizard configuration-based experience to deploy any analytic or optimization model into a fully functional Xpress Insight application. An example of how to create and edit these VDL files in Xpress Workbench is described later in this guide.

If you are developing locally on your machine, you should have a working installation of Python 3. The supported Python versions are 3.9.x - 3.13.x. For more, see the Xpress Insight Python Reference on the FICO web site.

You need to install FICO® Xpress v9.7 (including Xpress Workbench) and Xpress Insight. Both can make use of the same Python installation.

If you plan to deploy your models to a separate server running Xpress Insight, make sure that the same Python version is installed on the machine running the Xpress Insight Execution Workers.

Software

The xpressinsight module requires you have the following software installed:
  • FICO® Xpress v9.7 (which includes Xpress Workbench)
  • Xpress Insight v5.15
The module supports the following Python libraries, which are typically hosted on your own on-premises infrastructure.
  • pandas (versions 1.0.x to 2.3.x)
  • NumPy (versions 1.17 to 2.3.x)
  • Optional: Polars (versions 0.20.5 to 1.31.x)

The pandas and NumPy libraries are dependencies and are installed automatically by your package manager when you install the xpressinsight module, if you do not already have them installed. Dependencies are checked during installation and may be updated in the future.

Xpress Insight does not include Python binaries. The supported Python versions are 3.9.x - 3.13.x.
  • Windows users should get the binaries from www.python.org.
    • Advanced users who want to use multiple Python versions on a single machine, should download and install the Anaconda Python distribution from www.anaconda.com. Advanced users can also install the binaries from the Python or Anaconda website, or via homebrew.
  • Recent versions of Mac OS should have Python 3 pre-installed.
Windows users who are new to Python should install a Python version from www.python.org to make sure there is only a single version on their system. The Python installer will ask whether Python should be added to the system environment. Add Python as a system environment variable to ensure that both Xpress Workbench and the Xpress Insight Execution Worker can find the Python installation. Xpress Insight executes scenarios by sending jobs to an execution service running on an execution worker.
Note: To run Python from within Xpress Workbench, it is sufficient to add Python to the user environment variables (either in PATH or under PYTHON_EXE). However, Xpress Insight requires that it be added to the system environment.
Tip: If you have multiple Python environments installed, you can specify which environment you want to use for each project in the compiler options. For more information, see Compiler Options.

Useful Links

The following download links will be useful when following this guide.

Documentation

Software

Parent Topic Set up your Insight Python Development Environment

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.