from __future__ import annotations
import copy
import json
import random
import yaml
import requests
import itertools
import contextlib
import argparse
import os
from typing import Literal
from dateutil import parser, tz
import numpy as np
import gradio as gr
import pandas as pd
import plotly.io as pio
import plotly.express as px
from pandas.api.types import is_numeric_dtype, is_float_dtype
pio.templates.default = "plotly_white"
from spitfight.colosseum.client import ControllerClient
COLOSSEUM_UP = False
COLOSSEUM_DOWN_MESSAGE = f"
tag. However, because we also want to dynamically add new
# columns to the table and Gradio < 4.0 does not support updating `datatype` with
# `gr.DataFrame.update` yet, we need to manually walk into the DOM and replace
# the innerHTML of the model name cells with dynamically interpreted HTML.
# Desired feature tracked at https://github.com/gradio-app/gradio/issues/3732
dataframe_update_js = f"""
function format_model_link() {{
// Iterate over the cells of the first column of the leaderboard table.
for (let index = 1; index <= {len(global_tbm.full_df)}; index++) {{
// Get the cell.
var cell = document.querySelector(
`#tab-leaderboard > div > div > div > table > tbody > tr:nth-child(${{index}}) > td:nth-child(1) > div > span`
);
// If nothing was found, it likely means that now the visible table has less rows
// than the full table. This happens when the user filters the table. In this case,
// we should just return.
if (cell == null) break;
// This check exists to make this function idempotent.
// Multiple changes to the Dataframe component may invoke this function,
// multiple times to the same HTML table (e.g., adding and sorting cols).
// Thus, we check whether we already formatted the model names by seeing
// whether the child of the cell is a text node. If it is not,
// it means we already parsed it into HTML, so we should just return.
if (cell.firstChild.nodeType != 3) break;
// Decode and interpret the innerHTML of the cell as HTML.
var decoded_string = new DOMParser().parseFromString(cell.innerHTML, "text/html").documentElement.textContent;
var temp = document.createElement("template");
temp.innerHTML = decoded_string;
var model_anchor = temp.content.firstChild;
// Replace the innerHTML of the cell with the interpreted HTML.
cell.replaceChildren(model_anchor);
}}
// Return all arguments as is.
return arguments
}}
"""
# Custom CSS.
custom_css = """
/* Make ML.ENERGY look like a clickable logo. */
.text-logo {
color: #23d175 !important;
text-decoration: none !important;
}
/* Make the submit button the same color as the logo. */
.btn-submit {
background: #23d175 !important;
color: white !important;
border: 0 !important;
}
/* Center the plotly plot inside its container. */
.plotly > div {
margin: auto !important;
}
/* Limit the width of the first column to 300 px. */
table td:first-child,
table th:first-child {
max-width: 300px;
overflow: auto;
white-space: nowrap;
}
/* Make tab buttons larger */
.tab-nav > button {
font-size: 18px !important;
}
/* Color texts. */
.green-text {
color: #23d175 !important;
}
.red-text {
color: #ff3860 !important;
}
/* Flashing model name borders. */
@keyframes blink {
0%, 33%, 67%, 100% {
border-color: transparent;
}
17%, 50%, 83% {
border-color: #23d175;
}
}
/* Older browser compatibility */
@-webkit-keyframes blink {
0%, 33%, 67%, 100% {
border-color: transparent;
}
17%, 50%, 83% {
border-color: #23d175;
}
}
.model-name-text {
border: 2px solid transparent; /* Transparent border initially */
animation: blink 3s ease-in-out 1; /* One complete cycle of animation, lasting 3 seconds */
-webkit-animation: blink 3s ease-in-out 1; /* Older browser compatibility */
}
/* Grey out components when the Colosseum is down. */
.greyed-out {
pointer-events: none;
opacity: 0.4;
}
/* Make the Citation header larger */
#citation-header > div > span {
font-size: 16px !important;
}
"""
intro_text = """
How much energy do modern Large Language Models (LLMs) consume for inference?
We used Zeus to benchmark various open source LLMs in terms of how much time and energy they consume for inference.
Time and energy are of course not the only things we care about -- so we also benchmarked all of the models on a variety of NLP datasets,
including the ARC Challenge (reasoning), HellaSwag (common sense), and TruthfulQA (truthfulness).
For more detailed information, please take a look at the About tab.
Every benchmark is limited in some sense -- Before you interpret the results, please take a look at the Limitations section there, too.
"""
# The app will not start without a controller address set.
controller_addr = os.environ.get("COLOSSEUM_CONTROLLER_ADDR")
if controller_addr is None:
COLOSSEUM_UP = False
COLOSSEUM_DOWN_MESSAGE = "
Disabled Colosseum for local testing.
"
controller_addr = "localhost"
global_controller_client = ControllerClient(controller_addr=controller_addr, timeout=15)
# Load the list of models. To reload, the app should be restarted.
RANDOM_MODEL_NAME = "Random"
RANDOM_USER_PREFERENCE = "Two random models"
global_available_models = global_controller_client.get_available_models() if COLOSSEUM_UP else []
model_name_to_user_pref = {model: f"One is {model}" for model in global_available_models}
model_name_to_user_pref[RANDOM_MODEL_NAME] = RANDOM_USER_PREFERENCE
user_pref_to_model_name = {v: k for k, v in model_name_to_user_pref.items()}
# Colosseum helper functions.
def enable_interact():
return [gr.update(interactive=True)] * 2
def disable_interact():
return [gr.update(interactive=False)] * 2
def consumed_less_energy_message(energy_a, energy_b):
"""Return a message that indicates that the user chose the model that consumed less energy.
By default report in "%f %" but if the difference is larger than 2 times, report in "%f X".
"""
less_energy = min(energy_a, energy_b)
more_energy = max(energy_a, energy_b)
factor = less_energy / more_energy
how_much = f"{1 / factor:.1f}x" if factor <= 0.5 else f"{100 - factor * 100:.1f}%"
return f"That response also consumed {how_much} less energy ({energy_a:,.0f} J vs. {energy_b:,.0f} J)!
"
def consumed_more_energy_message(energy_a, energy_b):
"""Return a message that indicates that the user chose the model that consumed more energy.
By default report in "%f %" but if the difference is larger than 2 times, report in "%f X".
"""
less_energy = min(energy_a, energy_b)
more_energy = max(energy_a, energy_b)
factor = more_energy / less_energy
how_much = f"{factor:.1f}x" if factor >= 2.0 else f"{factor * 100 - 100:.1f}%"
return f"That response consumed {how_much} more energy ({energy_a:,.0f} J vs. {energy_b:,.0f} J).
"
# Colosseum event handlers
def on_load():
"""Intialize the dataframe, shuffle the model preference dropdown choices."""
dataframe = global_tbm.set_filter_get_df()
available_models = copy.deepcopy(global_available_models)
random.shuffle(available_models)
available_models.insert(0, RANDOM_MODEL_NAME)
return dataframe, gr.Dropdown.update(choices=[model_name_to_user_pref[model] for model in available_models])
def add_prompt_disable_submit(prompt, history_a, history_b):
"""Add the user's prompt to the two model's history and disable further submission."""
client = global_controller_client.fork()
return [
gr.Textbox.update(value=" ", interactive=False),
gr.Button.update(interactive=False),
gr.Dropdown.update(interactive=False),
history_a + [[prompt, ""]],
history_b + [[prompt, ""]],
client,
]
def generate_responses(client: ControllerClient, user_preference, history_a, history_b):
"""Generate responses for the two models."""
model_preference = user_pref_to_model_name[user_preference]
for resp_a, resp_b in itertools.zip_longest(
client.prompt(prompt=history_a[-1][0], index=0, model_preference=model_preference),
client.prompt(prompt=history_b[-1][0], index=1, model_preference=model_preference),
):
if resp_a is not None:
history_a[-1][1] += resp_a
if resp_b is not None:
history_b[-1][1] += resp_b
yield [history_a, history_b]
def make_resp_vote_func(victory_index: Literal[0, 1]):
"""Return a function that will be called when the user clicks on response preference vote buttons."""
def resp_vote_func(client: ControllerClient):
vote_response = client.response_vote(victory_index=victory_index)
model_name_a, model_name_b = map(lambda n: f"## {n}", vote_response.model_names)
energy_a, energy_b = vote_response.energy_consumptions
# User liked the model that also consumed less energy.
if (victory_index == 0 and energy_a <= energy_b) or (victory_index == 1 and energy_a >= energy_b):
energy_message = consumed_less_energy_message(energy_a, energy_b)
return [
# Disable response vote buttons
gr.Button.update(interactive=False), gr.Button.update(interactive=False),
# Reveal model names
gr.Markdown.update(model_name_a, visible=True), gr.Markdown.update(model_name_b, visible=True),
# Display energy consumption comparison message
gr.Markdown.update(energy_message, visible=True),
# Keep energy vote buttons hidden
gr.Button.update(visible=False, interactive=False), gr.Button.update(visible=False, interactive=False),
# Enable reset button
gr.Button.update(visible=True, interactive=True),
]
# User liked the model that consumed more energy.
else:
energy_message = consumed_more_energy_message(energy_a, energy_b)
return [
# Disable response vote buttons
gr.Button.update(interactive=False), gr.Button.update(interactive=False),
# Leave model names hidden
gr.Markdown.update(visible=False), gr.Markdown.update(visible=False),
# Display energy consumption comparison message
gr.Markdown.update(energy_message, visible=True),
# Reveal and enable energy vote buttons
gr.Button.update(visible=True, interactive=True), gr.Button.update(visible=True, interactive=True),
# Keep the reset button disabled
gr.Button.update(visible=False, interactive=False),
]
return resp_vote_func
def make_energy_vote_func(is_worth: bool):
"""Return a function that will be called when the user clicks on energy vote buttons."""
def energy_vote_func(client: ControllerClient, energy_message: str):
vote_response = client.energy_vote(is_worth=is_worth)
model_name_a, model_name_b = map(lambda n: f"## {n}", vote_response.model_names)
return [
# Reveal model names
gr.Markdown.update(model_name_a, visible=True), gr.Markdown.update(model_name_b, visible=True),
# Disable energy vote buttons
gr.Button.update(interactive=False), gr.Button.update(interactive=False),
# Enable reset button
gr.Button.update(interactive=True, visible=True),
# Append to the energy comparison message
energy_message[:-5] + (" Fair enough." if is_worth else " Wasn't worth it."),
]
return energy_vote_func
def play_again():
available_models = copy.deepcopy(global_available_models)
random.shuffle(available_models)
available_models.insert(0, RANDOM_MODEL_NAME)
return [
# Clear chatbot history
None, None,
# Enable prompt textbox and submit button
gr.Textbox.update(value="", interactive=True), gr.Button.update(interactive=True),
# Mask model names
gr.Markdown.update(value="", visible=False), gr.Markdown.update(value="", visible=False),
# Hide energy vote buttons and message
gr.Button.update(visible=False), gr.Button.update(visible=False), gr.Markdown.update(visible=False),
# Enable model preference dropdown and shuffle choices
gr.Dropdown.update(value=RANDOM_USER_PREFERENCE, choices=[model_name_to_user_pref[model] for model in available_models], interactive=True),
# Disable reset button
gr.Button.update(interactive=False, visible=False),
]
focus_prompt_input_js = """
function() {
for (let textarea of document.getElementsByTagName("textarea")) {
if (textarea.hasAttribute("autofocus")) {
textarea.focus();
return;
}
}
}
"""
with gr.Blocks(css=custom_css) as block:
tbm = gr.State(global_tbm) # type: ignore
with gr.Box():
gr.HTML("")
with gr.Tabs():
# Tab: Colosseum.
with gr.TabItem("Colosseum ⚔️️"):
if COLOSSEUM_UP:
gr.Markdown(open("docs/colosseum_top.md").read())
else:
gr.HTML(COLOSSEUM_DOWN_MESSAGE)
gr.HTML("The energy leaderboard is still available.
")
gr.HTML(COLOSSUMM_YOUTUBE_DEMO_EMBED_HTML)
with gr.Row():
model_preference_dropdown = gr.Dropdown(
value=RANDOM_USER_PREFERENCE,
label="Prefer a specific model?",
interactive=COLOSSEUM_UP,
elem_classes=None if COLOSSEUM_UP else ["greyed-out"],
)
with gr.Group():
with gr.Row():
prompt_input = gr.Textbox(
show_label=False,
placeholder="Input your prompt, e.g., 'Explain machine learning in simple terms.'",
container=False,
scale=20,
interactive=COLOSSEUM_UP,
elem_classes=None if COLOSSEUM_UP else ["greyed-out"],
)
prompt_submit_btn = gr.Button(
value="⚔️️ Fight!",
elem_classes=["btn-submit"] if COLOSSEUM_UP else ["greyed-out"],
min_width=60,
scale=1,
interactive=COLOSSEUM_UP,
)
with gr.Row():
masked_model_names = []
chatbots = []
resp_vote_btn_list: list[gr.component.Component] = []
with gr.Column():
with gr.Row():
masked_model_names.append(gr.Markdown(visible=False, elem_classes=["model-name-text"]))
with gr.Row():
chatbots.append(gr.Chatbot(label="Model A", elem_id="chatbot", height=400, elem_classes=None if COLOSSEUM_UP else ["greyed-out"]))
with gr.Row():
left_resp_vote_btn = gr.Button(value="👈 Model A is better", interactive=False)
resp_vote_btn_list.append(left_resp_vote_btn)
with gr.Column():
with gr.Row():
masked_model_names.append(gr.Markdown(visible=False, elem_classes=["model-name-text"]))
with gr.Row():
chatbots.append(gr.Chatbot(label="Model B", elem_id="chatbot", height=400, elem_classes=None if COLOSSEUM_UP else ["greyed-out"]))
with gr.Row():
right_resp_vote_btn = gr.Button(value="👉 Model B is better", interactive=False)
resp_vote_btn_list.append(right_resp_vote_btn)
with gr.Row():
energy_comparison_message = gr.HTML(visible=False)
with gr.Row():
worth_energy_vote_btn = gr.Button(value="The better response was worth 👍 the extra energy.", visible=False)
notworth_energy_vote_btn = gr.Button(value="Not really worth that much more. 👎", visible=False)
energy_vote_btn_list: list[gr.component.Component] = [worth_energy_vote_btn, notworth_energy_vote_btn]
with gr.Row():
play_again_btn = gr.Button("Play again!", visible=False, elem_classes=["btn-submit"])
gr.Markdown(open("docs/colosseum_bottom.md").read())
controller_client = gr.State()
(prompt_input
.submit(add_prompt_disable_submit, [prompt_input, *chatbots], [prompt_input, prompt_submit_btn, model_preference_dropdown, *chatbots, controller_client], queue=False)
.then(generate_responses, [controller_client, model_preference_dropdown, *chatbots], [*chatbots], queue=True, show_progress="hidden")
.then(enable_interact, None, resp_vote_btn_list, queue=False))
(prompt_submit_btn
.click(add_prompt_disable_submit, [prompt_input, *chatbots], [prompt_input, prompt_submit_btn, model_preference_dropdown, *chatbots, controller_client], queue=False)
.then(generate_responses, [controller_client, model_preference_dropdown, *chatbots], [*chatbots], queue=True, show_progress="hidden")
.then(enable_interact, None, resp_vote_btn_list, queue=False))
left_resp_vote_btn.click(
make_resp_vote_func(victory_index=0),
[controller_client],
[*resp_vote_btn_list, *masked_model_names, energy_comparison_message, *energy_vote_btn_list, play_again_btn],
queue=False,
)
right_resp_vote_btn.click(
make_resp_vote_func(victory_index=1),
[controller_client],
[*resp_vote_btn_list, *masked_model_names, energy_comparison_message, *energy_vote_btn_list, play_again_btn],
queue=False,
)
worth_energy_vote_btn.click(
make_energy_vote_func(is_worth=True),
[controller_client, energy_comparison_message],
[*masked_model_names, *energy_vote_btn_list, play_again_btn, energy_comparison_message],
queue=False,
)
notworth_energy_vote_btn.click(
make_energy_vote_func(is_worth=False),
[controller_client, energy_comparison_message],
[*masked_model_names, *energy_vote_btn_list, play_again_btn, energy_comparison_message],
queue=False,
)
(play_again_btn
.click(
play_again,
None,
[*chatbots, prompt_input, prompt_submit_btn, *masked_model_names, *energy_vote_btn_list, energy_comparison_message, model_preference_dropdown, play_again_btn],
queue=False,
)
.then(None, _js=focus_prompt_input_js, queue=False))
# Tab: Leaderboard.
with gr.Tab("Leaderboard"):
with gr.Box():
gr.HTML(intro_text)
# Block: Checkboxes to select benchmarking parameters.
with gr.Row():
with gr.Box():
gr.Markdown("### Benchmark results to show")
checkboxes: list[gr.CheckboxGroup] = []
for key, choices in global_tbm.schema.items():
# Specifying `value` makes everything checked by default.
checkboxes.append(gr.CheckboxGroup(choices=choices, value=choices[:1], label=key))
# Block: Leaderboard table.
with gr.Row():
dataframe = gr.Dataframe(type="pandas", elem_id="tab-leaderboard", interactive=False)
# Make sure the models have clickable links.
dataframe.change(None, None, None, _js=dataframe_update_js, queue=False)
# Table automatically updates when users check or uncheck any checkbox.
for checkbox in checkboxes:
checkbox.change(TableManager.set_filter_get_df, inputs=[tbm, *checkboxes], outputs=dataframe, queue=False)
# Block: Allow users to add new columns.
with gr.Box():
gr.Markdown("### Add custom columns to the table")
with gr.Row():
with gr.Column(scale=3):
with gr.Row():
colname_input = gr.Textbox(lines=1, label="Custom column name")
formula_input = gr.Textbox(lines=1, label="Formula (@sum, @len, @max, and @min are supported)")
with gr.Column(scale=1):
with gr.Row():
add_col_btn = gr.Button("Add to table (⏎)", elem_classes=["btn-submit"])
with gr.Row():
clear_input_btn = gr.Button("Clear")
with gr.Row():
add_col_message = gr.HTML("")
gr.Examples(
examples=[
["power", "energy / latency"],
["token_per_joule", "response_length / energy"],
["verbose", "response_length > @sum(response_length) / @len(response_length)"],
],
inputs=[colname_input, formula_input],
)
colname_input.submit(
TableManager.add_column,
inputs=[tbm, colname_input, formula_input],
outputs=[dataframe, add_col_message],
queue=False,
)
formula_input.submit(
TableManager.add_column,
inputs=[tbm, colname_input, formula_input],
outputs=[dataframe, add_col_message],
queue=False,
)
add_col_btn.click(
TableManager.add_column,
inputs=[tbm, colname_input, formula_input],
outputs=[dataframe, add_col_message],
queue=False,
)
clear_input_btn.click(
lambda: (None, None, None),
inputs=None,
outputs=[colname_input, formula_input, add_col_message],
queue=False,
)
# Block: Allow users to plot 2D and 3D scatter plots.
with gr.Box():
gr.Markdown("### Scatter plot (Hover over marker to show model name)")
with gr.Row():
with gr.Column(scale=3):
with gr.Row():
# Initialize the dropdown choices with the global TableManager with just the original columns.
axis_dropdowns = global_tbm.get_dropdown()
with gr.Column(scale=1):
with gr.Row():
plot_btn = gr.Button("Plot", elem_classes=["btn-submit"])
with gr.Row():
clear_plot_btn = gr.Button("Clear")
with gr.Accordion("Plot size (600 x 600 by default)", open=False):
with gr.Row():
plot_width_input = gr.Textbox("600", lines=1, label="Width (px)")
plot_height_input = gr.Textbox("600", lines=1, label="Height (px)")
with gr.Row():
plot = gr.Plot(value=global_tbm.plot_scatter(
plot_width_input.value,
plot_height_input.value,
x=axis_dropdowns[0].value,
y=axis_dropdowns[1].value,
z=axis_dropdowns[2].value,
)[0]) # type: ignore
with gr.Row():
plot_message = gr.HTML("")
add_col_btn.click(TableManager.update_dropdown, inputs=tbm, outputs=axis_dropdowns, queue=False) # type: ignore
plot_width_input.submit(
TableManager.plot_scatter,
inputs=[tbm, plot_width_input, plot_height_input, *axis_dropdowns],
outputs=[plot, plot_width_input, plot_height_input, plot_message],
queue=False,
)
plot_height_input.submit(
TableManager.plot_scatter,
inputs=[tbm, plot_width_input, plot_height_input, *axis_dropdowns],
outputs=[plot, plot_width_input, plot_height_input, plot_message],
queue=False,
)
plot_btn.click(
TableManager.plot_scatter,
inputs=[tbm, plot_width_input, plot_height_input, *axis_dropdowns],
outputs=[plot, plot_width_input, plot_height_input, plot_message],
queue=False,
)
clear_plot_btn.click(
lambda: (None,) * 7,
None,
outputs=[*axis_dropdowns, plot, plot_width_input, plot_height_input, plot_message],
queue=False,
)
# Block: Leaderboard date.
with gr.Row():
gr.HTML(f"Last updated: {current_date}
")
# Tab: About page.
with gr.Tab("About"):
# Read in LEADERBOARD.md
gr.Markdown(open("docs/leaderboard.md").read())
# Citation
with gr.Accordion("📚 Citation", open=False, elem_id="citation-header"):
citation_text = open("docs/citation.bib").read()
gr.Textbox(
value=citation_text,
label="BibTeX for the leaderboard and the Zeus framework used for benchmarking:",
lines=len(list(filter(lambda c: c == "\n", citation_text))),
interactive=False,
show_copy_button=True,
)
# Load the table on page load.
block.load(on_load, outputs=[dataframe, model_preference_dropdown], queue=False)
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("--share", action="store_true", help="Specify if sharing is enabled")
parser.add_argument("--concurrency", type=int, default=50)
args = parser.parse_args()
block.queue(concurrency_count=args.concurrency, api_open=False).launch(share=args.share, show_error=True)