Add exmamples

README.md

@@ -1,14 +1,14 @@
 ---
-title: Attention Visualizer
+title: Attribution Visualizer
 emoji: 🔎👀
-colorFrom: gray
+colorFrom: yellow
 colorTo: red
 sdk: gradio
-sdk_version: 4.21.0
+sdk_version: 4.44.0
 app_file: app.py
 pinned: false
 license: apache-2.0
-short_description: Discover how attention works in LLMs!
+short_description: Find which input tokens influence the output of your LLM.
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -1,13 +1,13 @@
+import io
 import torch
-from transformers import AutoTokenizer
-from lxt.models.llama import LlamaForCausalLM, attnlrp
-from lxt.utils import clean_tokens
 import gradio as gr
 import matplotlib.pyplot as plt
 import seaborn as sns
 import numpy as np
-import io
 from PIL import Image
+from transformers import AutoTokenizer
+from lxt.models.llama import LlamaForCausalLM, attnlrp
+from lxt.utils import clean_tokens
 
 # Load model and tokenizer
 model = LlamaForCausalLM.from_pretrained("TinyLlama/TinyLlama-1.1B-Chat-v1.0", torch_dtype=torch.bfloat16, device_map="cuda")
@@ -77,7 +77,6 @@ def generate_heatmap(input_tokens, all_relevances, output_tokens):
     non_zero_cols = np.sort(non_zero_cols)
     non_zero_cols = non_zero_cols[(non_zero_cols >= 0) & (non_zero_cols < attention_matrix.shape[1])]
 
-
     # Filter the matrix and input tokens
     filtered_matrix = attention_matrix[:, non_zero_cols]
     filtered_input_tokens = [input_tokens[i] for i in non_zero_cols]
@@ -114,15 +113,49 @@ def on_generate(input_text, num_tokens):
         heatmap
     )
 
+# Define example inputs
+examples = [
+    [
+        """Context: Mount Everest attracts many climbers, including highly experienced mountaineers.
+There are two main climbing routes, one approaching the summit from the southeast in Nepal (known as the standard route) and the other from the north in Tibet. While not posing substantial technical climbing challenges on the standard route, Everest presents dangers such as altitude sickness, weather, and wind, as well as hazards from avalanches and the Khumbu Icefall. As of November 2022, 310 people have died on Everest.
+Over 200 bodies remain on the mountain and have not been removed due to the dangerous conditions. The first recorded efforts to reach Everest's summit were made by British mountaineers.
+As Nepal did not allow foreigners to enter the country at the time, the British made several attempts on the north ridge route from the Tibetan side. After the first reconnaissance expedition by the British in 1921 reached 7,000 m (22,970 ft) on the North Col, the 1922 expedition pushed the north ridge route up to 8,320 m (27,300 ft), marking the first time a human had climbed above 8,000 m (26,247 ft).
+The 1924 expedition resulted in one of the greatest mysteries on Everest to this day: George Mallory and Andrew Irvine made a final summit attempt on 8 June but never returned, sparking debate as to whether they were the first to reach the top.
+Tenzing Norgay and Edmund Hillary made the first documented ascent of Everest in 1953, using the southeast ridge route. Norgay had reached 8,595 m (28,199 ft) the previous year as a member of the 1952 Swiss expedition. The Chinese mountaineering team of Wang Fuzhou, Gonpo, and Qu Yinhua made the first reported ascent of the peak from the north ridge on 25 May 1960. \nQuestion: How high did they climb in 1922? According to the text, the 1922 expedition reached 8,""",
+        10
+    ],
+    [
+        """Hurricane Katrina killed hundreds of people as it made landfall on New Orleans in 2005 - many of these deaths could have been avoided if alerts had been given one day earlier. Accurate weather forecasts are really life-saving.
+
+🔥 Now, NASA and IBM just dropped a game-changing new model: the first ever foundation model for weather! This means, it's the first time we have a generalist model not restricted to one task, but able to predict 160 weather variables!
+
+Prithvi WxC (Prithvi, “पृथ्वी”, is the Sanskrit name for Earth) - is a 2.3 billion parameter model, with an architecture close to previous vision transformers like Hiera.
+
+💡 But it comes with some important tweaks: under the hood, Prithvi WxC uses a clever transformer-based architecture with 25 encoder and 5 decoder blocks. It alternates between "local" and "global" attention to capture both regional and global weather patterns. How many weather variables can Prithvi predict? Prithvi can""",
+        15
+    ],
+    [
+        """Transformers v4.45.0 released: includes a lightning-fast method to build tools! ⚡️
+
+During user research with colleagues @MoritzLaurer and @Jofthomas , we discovered that the class definition currently in used to define a Tool in
+transformers.agents is a bit tedious to use, because it goes in great detail.
+
+➡️ So I’ve made an easier way to build tools: just make a function with type hints + a docstring, and add a @tool decorator in front.
+
+✅ Voilà, you’re good to go!
+
+How can you build tools simply in transformers? Just use the decorator""",
+        20
+    ]
+]
+
 # Define Gradio interface
 with gr.Blocks() as demo:
-    gr.Markdown("""# Extended Attention Visualization Demo
+    gr.Markdown("""# Attribution Visualization Demo
 
-This demo uses the library [LXT](https://lxt.readthedocs.io/en/latest/quickstart.html#tinyllama) under the hood.""")
+This demo uses the library [LXT](https://lxt.readthedocs.io/en/latest/quickstart.html#tinyllama) to attribute the output tokens to some input tokens.""")
     
-    input_text = gr.Textbox(label="Input Prompt", lines=5, value="""\
-Context: Mount Everest attracts many climbers, including highly experienced mountaineers. There are two main climbing routes, one approaching the summit from the southeast in Nepal (known as the standard route) and the other from the north in Tibet. While not posing substantial technical climbing challenges on the standard route, Everest presents dangers such as altitude sickness, weather, and wind, as well as hazards from avalanches and the Khumbu Icefall. As of November 2022, 310 people have died on Everest. Over 200 bodies remain on the mountain and have not been removed due to the dangerous conditions. The first recorded efforts to reach Everest's summit were made by British mountaineers. As Nepal did not allow foreigners to enter the country at the time, the British made several attempts on the north ridge route from the Tibetan side. After the first reconnaissance expedition by the British in 1921 reached 7,000 m (22,970 ft) on the North Col, the 1922 expedition pushed the north ridge route up to 8,320 m (27,300 ft), marking the first time a human had climbed above 8,000 m (26,247 ft). The 1924 expedition resulted in one of the greatest mysteries on Everest to this day: George Mallory and Andrew Irvine made a final summit attempt on 8 June but never returned, sparking debate as to whether they were the first to reach the top. Tenzing Norgay and Edmund Hillary made the first documented ascent of Everest in 1953, using the southeast ridge route. Norgay had reached 8,595 m (28,199 ft) the previous year as a member of the 1952 Swiss expedition. The Chinese mountaineering team of Wang Fuzhou, Gonpo, and Qu Yinhua made the first reported ascent of the peak from the north ridge on 25 May 1960. \
-Question: How high did they climb in 1922? According to the text, the 1922 expedition reached 8,""")
+    input_text = gr.Textbox(label="Input Prompt", lines=5, value=examples[0][0])
     num_tokens = gr.Slider(minimum=1, maximum=50, step=1, value=10, label="Number of tokens to generate")
     generate_button = gr.Button("Generate and Visualize")
     
@@ -137,6 +170,14 @@ Question: How high did they climb in 1922? According to the text, the 1922 exped
     output_tokens_state = gr.State([])
     relevances_state = gr.State([])
     
+    gr.Examples(
+        examples=examples,
+        inputs=[input_text, num_tokens],
+        outputs=[input_tokens_state, relevances_state, attention_on_inputs, output_tokens_state, current_tokens, generated_output, step_slider, heatmap_output],
+        fn=on_generate,
+        cache_examples=True
+    )
+    
     generate_button.click(
         on_generate,
         inputs=[input_text, num_tokens],