Awesome

Table of Contents

• What's Taipy?
• Key Features
• Quickstart
• Scenario and Data Management
• Taipy Studio
• User Interface Generation and Scenario & Data Management
• Contributing
• Code of Conduct
• License

⭐️ What's Taipy?

Taipy is designed for data scientists and machine learning engineers to build data & AI web applications.  

⭐️ Enables building production-ready web applications. <br /> ⭐️ No need to learn new languages; only Python is needed.<br /> ⭐️ Concentrate on data and AI algorithms without the complexities of development and deployment.<br />

✨ Key Features

<img src="readme_img/taipy_github_scenario.png" alt="Scenario Banner" width="49%" /> <img src="readme_img/taipy-github-optimized.png" alt="Front-End Animation" width="49%"/> <img src="readme_img/taipy_github_data_support.png" alt="Back-End Animation" width="49%" />

⚙️ Quickstart

To install the stable release of Taipy, run:

pip install taipy

Ready to Install Taipy? 🚀

Get everything set up in no time! Whether you're using a Conda environment or installing from source, follow our Installation Guide for step-by-step instructions.<br>

Excited to Dive In? 💡

Start building with Taipy today! Our Getting Started Guide is the perfect place to begin your journey and unlock the full potential of Taipy.

🔌 Scenario & Data Management

Let's create a simple scenario in Taipy that allows you to filter movie data based on your chosen genre.<br /> This scenario is designed as a straightforward pipeline.<br /> Every time you change your genre selection, the scenario runs to process your request.<br /> It then displays the top seven most popular movies in that genre.

⚠️ Keep in mind that in this example, we're using a very basic pipeline that consists of just one task. However,<br /> Taipy is capable of handling much more complex pipelines 🚀

Below is our filter function. This is a typical Python function, and it's the only task used in this scenario.

def filter_genre(initial_dataset: pd.DataFrame, selected_genre):
    filtered_dataset = initial_dataset[initial_dataset['genres'].str.contains(selected_genre)]
    filtered_data = filtered_dataset.nlargest(7, 'Popularity %')
    return filtered_data

This is the execution graph of the scenario we are implementing:

Taipy Studio

You can use the Taipy Studio extension in Visual Studio Code to configure your scenario with no code.<br /> Your configuration is automatically saved as a TOML file.<br /> Check out the Taipy Studio Documentation.

For more advanced use cases or if you prefer coding your configurations instead of using Taipy Studio,<br /> check out the movie genre demo scenario creation with this Demo.

User Interface Generation and Scenario & Data Management

This simple Taipy application demonstrates how to create a basic film recommendation system using Taipy.<br /> The application filters a dataset of films based on the user's selected genre and displays the top seven films in that genre by popularity. Here is the full code for both the front end and back end of the application.

import taipy as tp
import pandas as pd
from taipy import Config, Scope, Gui

# Defining the helper functions

# Callback definition - submits scenario with genre selection
def on_genre_selected(state):
    scenario.selected_genre_node.write(state.selected_genre)
    tp.submit(scenario)
    state.df = scenario.filtered_data.read()

## Set initial value to Action
def on_init(state):
    on_genre_selected(state)

# Filtering function - task
def filter_genre(initial_dataset: pd.DataFrame, selected_genre):
    filtered_dataset = initial_dataset[initial_dataset["genres"].str.contains(selected_genre)]
    filtered_data = filtered_dataset.nlargest(7, "Popularity %")
    return filtered_data

# The main script
if __name__ == "__main__":
    # Taipy Scenario & Data Management

    # Load the configuration made with Taipy Studio
    Config.load("config.toml")
    scenario_cfg = Config.scenarios["scenario"]

    # Start Taipy Orchestrator
    tp.Orchestrator().run()

    # Create a scenario
    scenario = tp.create_scenario(scenario_cfg)

    # Taipy User Interface
    # Let's add a GUI to our Scenario Management for a full application

    # Get the list of genres
    genres = [
        "Action", "Adventure", "Animation", "Children", "Comedy", "Fantasy", "IMAX",
        "Romance", "Sci-Fi", "Western", "Crime", "Mystery", "Drama", "Horror", "Thriller", "Film-Noir", "War", "Musical", "Documentary"
    ]

    # Initialization of variables
    df = pd.DataFrame(columns=["Title", "Popularity %"])
    selected_genre = "Action"

    # User interface definition
    my_page = """
# Film Recommendation

## Choose Your Favorite Genre
<|{selected_genre}|selector|lov={genres}|on_change=on_genre_selected|dropdown|>

## Here are the Top Seven Picks by Popularity
<|{df}|chart|x=Title|y=Popularity %|type=bar|title=Film Popularity|>
    """

    Gui(page=my_page).run()

And the final result:

⚒️ Contributing

Want to help build Taipy? Check out our Contributing Guide.

🪄 Code of Conduct

Want to be part of the Taipy community? Check out our Code of Conduct

🪪 License

Copyright 2021-2024 Avaiga Private Limited

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at Apache License

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.