add params to gr.Interface and gr.ChatInterface

.changeset/cold-trees-wash.md

@@ -0,0 +1,5 @@
+---
+"gradio": minor
+---
+
+feat:add params to `gr.Interface` and `gr.ChatInterface`

gradio/blocks.py

@@ -512,9 +512,9 @@ def __init__(
             analytics_enabled: Whether to allow basic telemetry. If None, will use GRADIO_ANALYTICS_ENABLED environment variable or default to True.
             mode: A human-friendly name for the kind of Blocks or Interface being created. Used internally for analytics.
             title: The tab title to display when this is opened in a browser window.
-            css: Custom css or path to custom css file to apply to entire Blocks.
-            js: Custom js or path to custom js file to run when demo is first loaded.
-            head: Custom html to insert into the head of the page. This can be used to add custom meta tags, scripts, stylesheets, etc. to the page.
+            css: Custom css as a string or path to a css file. This css will be included in the demo webpage.
+            js: Custom js or path to js file to run when demo is first loaded. This javascript will be included in the demo webpage.
+            head: Custom html to insert into the head of the demo webpage. This can be used to add custom meta tags, scripts, stylesheets, etc. to the page.
         """
         self.limiter = None
         if theme is None:

gradio/chat_interface.py

@@ -68,6 +68,8 @@ def __init__(
         description: str | None = None,
         theme: Theme | str | None = None,
         css: str | None = None,
+        js: str | None = None,
+        head: str | None = None,
         analytics_enabled: bool | None = None,
         submit_btn: str | None | Button = "Submit",
         stop_btn: str | None | Button = "Stop",
@@ -79,18 +81,20 @@ def __init__(
     ):
         """
         Parameters:
-            fn: the function to wrap the chat interface around. Should accept two parameters: a string input message and list of two-element lists of the form [[user_message, bot_message], ...] representing the chat history, and return a string response. See the Chatbot documentation for more information on the chat history format.
-            chatbot: an instance of the gr.Chatbot component to use for the chat interface, if you would like to customize the chatbot properties. If not provided, a default gr.Chatbot component will be created.
-            textbox: an instance of the gr.Textbox component to use for the chat interface, if you would like to customize the textbox properties. If not provided, a default gr.Textbox component will be created.
-            additional_inputs: an instance or list of instances of gradio components (or their string shortcuts) to use as additional inputs to the chatbot. If components are not already rendered in a surrounding Blocks, then the components will be displayed under the chatbot, in an accordion.
+            fn: The function to wrap the chat interface around. Should accept two parameters: a string input message and list of two-element lists of the form [[user_message, bot_message], ...] representing the chat history, and return a string response. See the Chatbot documentation for more information on the chat history format.
+            chatbot: An instance of the gr.Chatbot component to use for the chat interface, if you would like to customize the chatbot properties. If not provided, a default gr.Chatbot component will be created.
+            textbox: An instance of the gr.Textbox component to use for the chat interface, if you would like to customize the textbox properties. If not provided, a default gr.Textbox component will be created.
+            additional_inputs: An instance or list of instances of gradio components (or their string shortcuts) to use as additional inputs to the chatbot. If components are not already rendered in a surrounding Blocks, then the components will be displayed under the chatbot, in an accordion.
             additional_inputs_accordion_name: Deprecated. Will be removed in a future version of Gradio. Use the `additional_inputs_accordion` parameter instead.
             additional_inputs_accordion: If a string is provided, this is the label of the `gr.Accordion` to use to contain additional inputs. A `gr.Accordion` object can be provided as well to configure other properties of the container holding the additional inputs. Defaults to a `gr.Accordion(label="Additional Inputs", open=False)`. This parameter is only used if `additional_inputs` is provided.
-            examples: sample inputs for the function; if provided, appear below the chatbot and can be clicked to populate the chatbot input.
+            examples: Sample inputs for the function; if provided, appear below the chatbot and can be clicked to populate the chatbot input.
             cache_examples: If True, caches examples in the server for fast runtime in examples. The default option in HuggingFace Spaces is True. The default option elsewhere is False.
             title: a title for the interface; if provided, appears above chatbot in large font. Also used as the tab title when opened in a browser window.
             description: a description for the interface; if provided, appears above the chatbot and beneath the title in regular font. Accepts Markdown and HTML content.
             theme: Theme to use, loaded from gradio.themes.
-            css: custom css or path to custom css file to use with interface.
+            css: Custom css as a string or path to a css file. This css will be included in the demo webpage.
+            js: Custom js or path to js file to run when demo is first loaded. This javascript will be included in the demo webpage.
+            head: Custom html to insert into the head of the demo webpage. This can be used to add custom meta tags, scripts, stylesheets, etc. to the page.
             analytics_enabled: Whether to allow basic telemetry. If None, will use GRADIO_ANALYTICS_ENABLED environment variable if defined, or default to True.
             submit_btn: Text to display on the submit button. If None, no button will be displayed. If a Button object, that button will be used.
             stop_btn: Text to display on the stop button, which replaces the submit_btn when the submit_btn or retry_btn is clicked and response is streaming. Clicking on the stop_btn will halt the chatbot response. If set to None, stop button functionality does not appear in the chatbot. If a Button object, that button will be used as the stop button.
@@ -106,6 +110,8 @@ def __init__(
             css=css,
             title=title or "Gradio",
             theme=theme,
+            js=js,
+            head=head,
         )
         self.concurrency_limit = concurrency_limit
         self.fn = fn
@@ -189,7 +195,7 @@ def __init__(
                                 scale=7,
                                 autofocus=autofocus,
                             )
-                        if submit_btn:
+                        if submit_btn is not None:
                             if isinstance(submit_btn, Button):
                                 submit_btn.render()
                             elif isinstance(submit_btn, str):
@@ -203,7 +209,7 @@ def __init__(
                                 raise ValueError(
                                     f"The submit_btn parameter must be a gr.Button, string, or None, not {type(submit_btn)}"
                                 )
-                        if stop_btn:
+                        if stop_btn is not None:
                             if isinstance(stop_btn, Button):
                                 stop_btn.visible = False
                                 stop_btn.render()
@@ -223,7 +229,7 @@ def __init__(
 
                 with Row():
                     for btn in [retry_btn, undo_btn, clear_btn]:
-                        if btn:
+                        if btn is not None:
                             if isinstance(btn, Button):
                                 btn.render()
                             elif isinstance(btn, str):