re-init

.gitattributes

@@ -0,0 +1,34 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1 @@
+env/

README.md

@@ -0,0 +1,13 @@
+---
+title: REST API with Gradio and Huggingface Spaces
+emoji: 👩‍💻
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 5.34.2
+app_file: app.py
+pinned: false
+license: openrail
+---
+
+This is a demo from this article: https://www.tomsoderlund.com/ai/building-ai-powered-rest-api

app.py

@@ -0,0 +1,139 @@
+import gradio as gr
+import gradio.themes
+import numpy as np
+from style import js_func, css_func
+import tempfile
+import pandas as pd
+
+def greet(name="Stranger", intensity=1, exclaim=False):
+    greeting = f"Hello, {name}{'!' * int(intensity)}"
+    if exclaim:
+        greeting = greeting.upper()
+    return greeting
+
+def calculator(num1, operation, num2):
+    if operation == "add":
+        result = num1 + num2
+    elif operation == "subtract":
+        result = num1 - num2
+    elif operation == "multiply":
+        result = num1 * num2
+    elif operation == "divide":
+        if num2 == 0:
+            raise gr.Error("Cannot divide by zero!")
+        result = num1 / num2
+    return result
+
+def sepia(input_img):
+    sepia_filter = np.array([
+        [0.393, 0.769, 0.189],
+        [0.349, 0.686, 0.168],
+        [0.272, 0.534, 0.131]
+    ])
+    sepia_img = input_img @ sepia_filter.T
+    sepia_img = np.clip(sepia_img, 0, 255).astype(np.uint8)
+    return sepia_img
+
+def download_text(text):
+    if not text:
+        text = ""
+    with tempfile.NamedTemporaryFile(delete=False, suffix=".txt", mode="w", encoding="utf-8") as f:
+        f.write(text)
+        return f.name
+
+def download_csv(result):
+    if result is None:
+        result = ""
+    df = pd.DataFrame({"Result": [result]})
+    with tempfile.NamedTemporaryFile(delete=False, suffix=".csv", mode="w", encoding="utf-8") as f:
+        df.to_csv(f, index=False)
+        return f.name
+
+theme = gr.Theme.from_hub("LPX55/modal_ai")
+
+with gr.Blocks(theme=theme, js=js_func, css=css_func) as demo:
+    with gr.Sidebar(width="25vw"):
+        gr.Image("logo.png", width=80, show_label=False)
+        gr.Markdown("""
+        # 🤖 Gradio API Demo
+        _Build, test, and share AI tools instantly!_
+
+        ---
+        **Navigation**
+        - [Greeting](#greeting)
+        - [Calculator](#calculator)
+        - [Sepia Image](#sepia-image)
+        ---
+        [GitHub Repo](https://github.com/yourrepo) | [Docs](https://yourdocs)
+        ---
+        **Tips:**  
+        - Try the examples in each tab!
+        - Download your results with the button on the right.
+        ---
+
+        _v1.0.0 | Powered by Gradio_
+        """)
+        gr.Code(
+          """from gradio_client import Client
+client = Client("YOUR_URL")
+print(client.predict("Alex", 5, False, api_name="/greet"))
+          
+          """, language="python", label="**API Example:**"
+        )
+        gr.Button("Reset All", elem_id="reset-btn")
+
+    with gr.Tab("Greeting"):
+        gr.Markdown("## Greeting Generator")
+        with gr.Row():
+            with gr.Column():
+                name = gr.Textbox(label="Name", info="Enter your name", placeholder="e.g. Alex")
+                intensity = gr.Slider(1, 20, value=3, step=1, label="Intensity", info="How excited should the greeting be?")
+                with gr.Accordion("Advanced Options", open=False):
+                    exclaim = gr.Checkbox(label="Shout (all caps)", info="Make the greeting all uppercase and add exclamations")
+                greet_btn = gr.Button("Greet")
+            with gr.Column():
+                greet_output = gr.Textbox(label="Greeting", lines=2)
+                download_greet_btn = gr.DownloadButton(label="Download Greeting", value=download_text, inputs=greet_output)
+                gr.Examples(
+                    [["Jill", 1, False], ["Sam", 3, True], ["Alex", 5, False]],
+                    inputs=[name, intensity, exclaim],
+                    outputs=greet_output,
+                    fn=greet
+                )
+        greet_btn.click(greet, [name, intensity, exclaim], greet_output)
+
+    with gr.Tab("Calculator"):
+        gr.Markdown("## Toy Calculator")
+        with gr.Row():
+            with gr.Column():
+                num1 = gr.Number(label="Number 1", info="First number")
+                operation = gr.Radio(["add", "subtract", "multiply", "divide"], label="Operation", info="Choose the operation")
+                num2 = gr.Number(label="Number 2", info="Second number")
+                calc_btn = gr.Button("Calculate")
+            with gr.Column():
+                calc_output = gr.Number(label="Result")
+                download_calc_btn = gr.DownloadButton(label="Download Result", value=download_csv, inputs=calc_output)
+                gr.Examples(
+                    [[45, "add", 3], [3.14, "divide", 2], [144, "multiply", 2.5], [0, "subtract", 1.2]],
+                    inputs=[num1, operation, num2],
+                    outputs=calc_output,
+                    fn=calculator
+                )
+        calc_btn.click(calculator, [num1, operation, num2], calc_output)
+
+    with gr.Tab("Sepia Image"):
+        gr.Markdown("## Sepia Image Filter")
+        image_input = gr.Image(label="Input Image", type="numpy")
+        sepia_btn = gr.Button("Apply Sepia")
+        image_output = gr.Image(label="Sepia Image")
+        sepia_btn.click(sepia, image_input, image_output)
+
+    gr.Markdown("""
+    ---
+    ## 📡 API Usage
+    - Every function in this demo is automatically available as a REST API!
+    - View the [OpenAPI schema](./openapi.json) or click "Use via API" in the footer.
+    - Try the [gradio_client](https://www.gradio.app/guides/getting-started-with-the-python-client) or [@gradio/client](https://www.gradio.app/guides/getting-started-with-the-js-client) to call these endpoints programmatically.
+    """)
+
+demo.launch(mcp_server=True)

requirements.txt

@@ -0,0 +1,3 @@
+gradio[mcp]
+numpy
+pandas

style.py

@@ -0,0 +1,39 @@
+js_func = """
+function refresh() {
+    const url = new URL(window.location);
+
+    if (url.searchParams.get('__theme') !== 'dark') {
+        url.searchParams.set('__theme', 'dark');
+        window.location.href = url.href;
+    }
+}
+"""
+
+css_func = """
+.sidebar{
+    background-color: (--block-border-color) !important;
+    border-right: #373737 !important;
+    border-right-width: 3px !important;
+    border-right-style: solid !important;
+}
+.post{
+    color: #1c1a1a !important;
+    font-size: 0.8rem !important;
+    padding: 4px 2px !important;
+}
+.highlight{
+    color: #1c1a1a !important;
+    font-size: 0.8rem !important;
+    padding: 4px 2px !important;
+}
+.prose a{
+    color: #aba9a9 !important;
+}
+.prose a:visited{
+    color: #6b6767 !important;
+}
+.prose hr {
+    margin-top: 2em !important;
+    margin-bottom: 2em !important;
+
+"""