The run() function

Taipy provides you three runnable services: Taipy GUI, Taipy REST, and Taipy Core. You can run Taipy services by calling the method run() from the service instance either Gui, Rest, or Core. You can also use taipy.run() to run multiple service(s) together.

Running from the main module

As you can see in the following examples, the code to run a Taipy service is set within a if block checking if the special variable __name__ equals to "__main__". It's a standard boilerplate code that protects users from accidentally invoking the script when they didn't intend to. In particular the module is called when Taipy spawns a new Process.

If you need to execute some code prior to start a Taipy service (like setting some variables, initializing some data, submitting some tasks, create a scenario) we strongly recommend to set this code within the if __name__ == "__main__" block.

Running all Taipy services: Gui, Core and Rest

You can run all Taipy services together by using taipy.run() with the code below:

import taipy as tp

if __name__ == "__main__":
    gui = tp.Gui(page="# Getting started with *Taipy*")
    rest = tp.Rest()

    tp.run(gui, rest, title="Taipy application")

Since Taipy REST relies on Taipy Core when running the Taipy REST service, Taipy Core will automatically run along with it. Therefore, Taipy Core will run with Taipy GUI and Taipy REST in the previous code example.

Running Gui and Core

If you don't want to expose REST APIs to manage the core entities, you can run Taipy GUI along with Taipy Core together with the following code:

import taipy as tp

if __name__ == "__main__":
    core = tp.Core()
    gui = tp.Gui(page="# Getting started with *Taipy*")

    tp.run(gui, core, title="Taipy application")

Running Gui alone

You can run the GUI service alone with the following code:

import taipy as tp

if __name__ == "__main__":
    gui = tp.Gui(page="# Getting started with *Taipy*")

    tp.run(gui, title="Taipy application")  # It is equivalent to gui.run(title="Taipy application")

Running Core alone

You can run the Core service alone with the following code:

import taipy as tp

if __name__ == "__main__":
    core = tp.Core()

    tp.run(core)  # It is equivalent to core.run()

By starting the Core service, all configuration updates will be blocked. To continue to configure your application, stop the Core service by running core.stop().

Note

On a Taipy application that uses the Taipy Core API, running the Core service is required to execute jobs.

Running Rest and Core

If you don't need to run GUI, you can run Taipy Core along with Taipy REST together. By default, running Rest, also runs Core as the REST service relies on the Core service :

import taipy as tp

if __name__ == "__main__":
    rest = tp.Rest()

    tp.run(rest)  # It is equivalent to rest.run()