Return the app as html

[anandakrishnankb]

How to return the shap app = xpl.run_app() as HTML so it can be rendered at the frontend as needed

[guillaume-vignal]

Hello,

Sorry for the delay. Did you manage to find a solution, or could you provide more details on what you're expecting?

If you're looking to render the Shapash xpl.run_app() output as an HTML component that can be integrated into your frontend, there are a few approaches you can consider:

1. Generate a Shapash Report (Recommended)

Shapash provides a built-in way to generate a report in a structured format. Instead of running the interactive Dash app, you can create an HTML report that can be easily embedded in your frontend.

xpl.generate_report(output_file='shapash_report.html')

Once generated, you can serve this file in your backend and embed it in your frontend using:

<iframe src="path/to/shapash_report.html" width="100%" height="600px"></iframe>

This approach is useful if you want to provide a static, shareable version of the insights without running a live Dash app.

📌 More details: You can check the official Shapash tutorial on report generation here

---

2. Running the Shapash App Dynamically

If you prefer to serve the interactive app, you can use xpl.run_app(), which launches a Dash-based web app:

app_url = xpl.run_app()
print(f"Shapash app running at: {app_url}")

Then, in your frontend:

<iframe src="http://127.0.0.1:5000" width="100%" height="600px"></iframe>

Note:

• If you're deploying this on a server, ensure the app is accessible over a public IP.
• Dash runs by default on localhost, but you can configure it to run on an external address.

---

3. Customizing & Extending Shapash (Advanced)

If you need more customization, you can look at the nvidia-xai project, which tweaks Shapash for a different use case:

🔗 Repo: https://github.com/danton267/nvidia-xai/tree/main
🔗 Live App Example: https://dash-demo.plotly.host/nvidia-xai/practical-XAI/loan-default-dataset

This project extends Shapash's capabilities with a customized Dash UI. If you need a similar approach, you can fork the repository and modify the layout or components according to your needs.

---

Which Solution is Best for You?

• Static HTML Report? → Use xpl.generate_report()
• Interactive App? → Use xpl.run_app()
• Fully Custom UI? → Check the nvidia-xai implementation

Let us know which approach fits your use case, and we can help further!