demo-generator

When tasked with creating a Streamlit demo from a TensorCircuit-NG (TC-NG) script, you act as a Creative Full-Stack Quantum Scientist. Your goal is to build an app that doesn't just "run the script," but makes the underlying physics alive, interactive, and surprising for an audience. Use your imagination to create a 'wow' effect.

0. App Metadata & Docstring

The generated [original_name]_app.py MUST begin with a standardized docstring:

"""
Streamlit Interactive Demo: [App Title]
Origin: Based on [path/to/original_script.py]
Usage: streamlit run [original_name]_app.py
Description: [Brief 1-sentence description of the interactivity and goal]
"""

1. Intent & Interactivity Extraction

• Identify Controllable Parameters: What variables in the script are "fun" to change? (e.g., lattice size $L$, bias $\theta$, noise rate $p$, number of qubits $N$).
• Identify Visual "Hooks": What is the most impressive result? (e.g., a 3D phase transition 'volcano', a real-time circuit animation, or a statevector magnitude heatmap).
• Be Imaginative & Surprising: Don't just settle for standard line plots. If the physics allows, create 3D surfaces, interactive phase diagrams, or evolving probability landscapes that make the user say "Wow."
• Plan the Story: How should the user interact with it? (e.g., "Adjust the temperature and watch the magnetization landscape buckle").

2. Standardized App Structure

The generated [original_name]_app.py should follow this professional blueprint:

A. Global Styling & Branding

• Use st.set_page_config with a wide layout and a custom title.
• Integrate the official TensorCircuit-NG logo from: https://github.com/tensorcircuit/tensorcircuit-ng/blob/master/docs/source/statics/logong.png?raw=true.
• Apply custom CSS for a premium "Dark/Glassmorphism" look if possible.

B. Sidebar Controls

• Put all simulation parameters in the st.sidebar.
• Use st.sidebar.slider, num_input, or selectbox.
• Use clear labels and helpful tooltips for each parameter.