Deploy Pak Angels AI Tutor

README.md

@@ -7,6 +7,7 @@ sdk: gradio
 sdk_version: 5.50.0
 app_file: app.py
 pinned: false
+suggested_hardware: zero-a10g
 ---
 
 # Pak Angels AI Tutor
@@ -194,6 +195,9 @@ testing, run `python app.py`.
 Hugging Face build failures: Review the Space build logs, confirm all required
 files are uploaded, and check that only necessary dependencies are listed.
 
+ZeroGPU or GPU startup error: This app does not need GPU hardware. In the Space
+Settings, set Hardware to a CPU option such as CPU Basic, then restart the Space.
+
 ## Security
 
 - API keys must never be committed to Git.

app.py

@@ -9,6 +9,29 @@ from openai_service import format_openai_error, stream_tutor_response
 from prompts import ABOUT_PAK_ANGELS, MODULES, build_system_instructions
 
 
+BUILD_ID = "pak-angels-zerogpu-2026-07-11-v2"
+
+
+try:
+    import spaces
+except ImportError:
+    class _SpacesFallback:
+        @staticmethod
+        def GPU(*args, **kwargs):
+            if args and callable(args[0]) and len(args) == 1 and not kwargs:
+                return args[0]
+
+            def decorator(function):
+                return function
+
+            return decorator
+
+    spaces = _SpacesFallback()
+
+
+print(f"Starting {APP_NAME} build {BUILD_ID}")
+
+
 PRIVACY_NOTICE = (
     "Privacy notice: Do not enter confidential, proprietary, financial, medical, "
     "personal, or otherwise sensitive information into the AI Tutor."
@@ -171,6 +194,7 @@ def generate_response(history: list[dict[str, str]] | None, module_name: str):
         yield history
 
 
+@spaces.GPU(duration=120)
 def submit_message(message: str, history: list[dict[str, str]] | None, module_name: str):
     textbox, updated_history = add_user_message(message, history)
     yield textbox, updated_history

requirements.txt

@@ -1,2 +1,3 @@
 gradio>=5.50,<6
 openai>=1.93,<2
+spaces>=0.35,<1