init

.gitattributes

@@ -1,35 +1,35 @@
-*.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
-*.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
+*.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
+*.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

README.md

@@ -1,13 +1,19 @@
----
-title: Hello World
-emoji: 🦀
-colorFrom: blue
-colorTo: yellow
-sdk: gradio
-sdk_version: 4.42.0
-app_file: app.py
-pinned: false
-license: cc-by-nc-sa-4.0
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Hello World
+emoji: 🚀
+colorFrom: blue
+colorTo: yellow
+sdk: gradio
+sdk_version: 4.42.0
+app_file: app.py
+pinned: false
+license: cc-by-nc-sa-4.0
+---
+
+> Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+<!--- Actual README --->
+
+# Hello World
+
+This is just a project for me to learn how HuggingFace Spaces works, and how to use inference with Spaces via API...

app.py

@@ -1,49 +1,157 @@
-import gradio as gr
-
-
-def greet(name: str) -> str:
-
-    if not name.strip():
-        return gr.update()
-
-    return f"Hello, {name.capitalize()}!"
-
-
-with gr.Blocks() as demo:
-
-    gr.Markdown("""<h1 align="center">Hello World</h1>""")
-    gr.Markdown("""<p align="center">Typing whatever you want to greet below:</p>""")
-
-    with gr.Row():
-
-        user_input = gr.Textbox(
-            value="",
-            label="name",
-            show_label=False,
-            lines=1,
-            max_lines=1,
-            interactive=True,
-            placeholder="World",
-        )
-
-        text_output = gr.Textbox(
-            value="",
-            label="output",
-            show_label=False,
-            lines=1,
-            max_lines=1,
-            interactive=False,
-        )
-
-    btn = gr.Button("Run")
-    btn.click(
-        fn=greet,
-        inputs=[user_input],
-        outputs=[text_output],
-        show_progress="hidden",
-        show_api=True,
-        api_name="main",
-    )
-
-
-demo.launch()
+# === Included SDK === #
+import gradio as gr
+
+# === Installed from requirements.txt === #
+from PIL import Image
+import numpy as np
+import torch
+
+# === Python built-in === #
+import sys
+import os
+
+# ============================================================ #
+# Q: Why use gr.Blocks instead of gr.Interface?                #
+# A: Only Blocks supports Layouts (and I'm more used to this)  #
+# ============================================================ #
+with gr.Blocks() as demo:
+
+    # ======================================== #
+    # Markdown is pointless in API usage... XD #
+    # ======================================== #
+    gr.Markdown("""<h1 align="center">Hello World</h1>""")
+    gr.Markdown("""<p align="center">For <b>learning</b> purposes only...</p>""")
+
+    # ====================================== #
+    # function name is overrides by api_name #
+    # ====================================== #
+    def log() -> str:
+        info: list[str] = []
+        info.append(f"OS: {os.name}")
+        info.append(f"Python: {sys.version.split(' ', 1)[0]}")
+        info.append(f"CUDA: {torch.cuda.is_available()}")
+
+        return "\n".join(info)
+
+    def proc_image(
+        img: np.ndarray, target_w: int, target_h: int
+    ) -> list[str, Image.Image]:
+
+        input_h, input_w, channels = img.shape
+
+        log = f"Resize a {input_w}x{input_h} image to {target_w}x{target_h}..."
+
+        image = Image.fromarray(img)
+        image = image.resize((target_w, target_h))
+
+        return [log, image]
+
+    with gr.Row():
+
+        with gr.Column():
+
+            # ============================= #
+            # Images take base64 str in API #
+            # ============================= #
+
+            input_image = gr.Image(
+                value=None,
+                image_mode="RGB",
+                sources="upload",
+                type="numpy",
+                label="Input",
+                show_label=True,
+                show_download_button=False,
+                container=False,
+                visible=True,
+                interactive=True,
+                show_share_button=False,
+                show_fullscreen_button=False,
+            )
+
+            with gr.Row():
+                target_w = gr.Slider(
+                    minimum=1,
+                    maximum=1024,
+                    step=1,
+                    value=512,
+                    label="width",
+                    show_label=True,
+                    container=False,
+                    interactive=True,
+                )
+
+                target_h = gr.Slider(
+                    minimum=1,
+                    maximum=1024,
+                    step=1,
+                    value=512,
+                    label="width",
+                    show_label=True,
+                    container=False,
+                    interactive=True,
+                )
+
+            output_image = gr.Image(
+                value=None,
+                image_mode="RGB",
+                sources="upload",
+                type="pil",
+                label="Output",
+                show_label=True,
+                show_download_button=False,
+                container=False,
+                visible=True,
+                interactive=False,
+                show_share_button=False,
+                show_fullscreen_button=False,
+            )
+
+            btn1 = gr.Button("Resize", container=False)
+
+        with gr.Column():
+
+            # ============================= #
+            # Buttons do not show up in API #
+            # ============================= #
+
+            btn2 = gr.Button("Print Info", container=False)
+
+    # ==================================== #
+    # label is shown in the returns in API #
+    # ==================================== #
+
+    console_logs = gr.Text(
+        value="...",
+        label="Logs",
+        show_label=True,
+        lines=1,
+        max_lines=8,
+        interactive=False,
+        container=True,
+    )
+
+    # =================================== #
+    # api_name is used as endpoint in API #
+    # =================================== #
+
+    btn1.click(
+        fn=proc_image,
+        inputs=[input_image, target_w, target_h],
+        outputs=[console_logs, output_image],
+        show_progress="hidden",
+        show_api=True,
+        api_name="resizeImage",
+    )
+
+    btn2.click(
+        fn=log,
+        inputs=None,
+        outputs=console_logs,
+        show_progress="hidden",
+        show_api=True,
+        api_name="systemInfo",
+    )
+
+
+demo.launch()

requirements.txt

@@ -0,0 +1,4 @@
+torch~=2.4.0
+Pillow~=10.1.0
+opencv-python~=4.8.0
+numpy