Python setup

Requires the following resources:

  • An internet connection to download and install Simian GUI from our PyPi server (or an offline alternative).
  • License file valid for your machine.

Setup steps:

  1. Create and activate a Python environment.

    Note: If you want to run locally, use Python 3.8 or 3.9. Python 3.10 and above are currently not supported by PyWebview.

  2. Install the packages using pip:

    pip install --extra-index-url simian-gui simian-local simian-examples

    Note that for installation on a deployment server the simian-local and simian-examples packages are not required.

    1. The simian-local package installs pywebview as a dependency. To verify it is installed correctly on your system, run the following python commands. A window, displaying the PyWebview web page, should open.

      import webview
      webview.create_window('Hello world', '')
    2. If you want to use Redis cache (for deployed mode) it can be specified as optional dependency of the simian-gui:

      pip install simian-gui[redis]
    3. If you need to troubleshoot license failures, you may also want to install the pyarmor dependency.

      pip install simian-gui[pyarmor]
  3. Make your license file available by specifying its location in the PYARMOR_LICENSE environment variable, as documented in the license section

Testing your setup

You can test your environment setup by running the following commands in your Python environment:

import simian.gui
form = simian.gui.Form()

If you get a Form object, your environment is setup correctly. If pywebview is installed correctly in your Python environment, you should be able to start the BallThrower example locally by running the following commands:

import simian.local
simian.local.Uiformio("simian.examples.ballthrower", window_title="Ball Thrower")

If you get an error, you can check this against these error messages and solutions:

  • ModuleNotFoundError: No module named 'simian' Simian GUI was not found on the Python path. Ensure that the simian-gui and simian-local packages are installed.

  • ModuleNotFoundError: No module named 'simian.examples.ballthrower' The simian-examples package was not found on the Python path. Ensure that the simian-examples package is installed.

  • ModuleNotFoundError: No module named xxx Ensure that all dependencies are installed in your Python environment.

  • License errors and potential solutions are described in the Invalid license message section.

Simian GUI contents

A full Simian GUI installation in your Python environment installs the following folders and files in the site-packages folder:

From simian-examples:

  • simian
    • examples
      • Module implementing the BallThrower application. It contains the gui_init and gui_event functions that define the user interface of the application.
      • Module with a class that implements the ball throwing model.
    • version.txt version information.

From simian-gui:

  • pytransform: Utility for license validation.
  • simian
    • gui Folder containing Simian GUI code.
    • config.json File containing the version number of the front-end.
    • Utility for handling callbacks.
    • version.txt version information.

From simian-local:

  • simian
    • html Folder containing the front-end build for PyWebview.
    • Utility for communication with tht PyWebview window.
    • The Simian Local module.
    • local.pyi Python stub file containing type hints for the module.