fix: Corrigir bug Gradio 4.44.0 e adicionar error handling

README.md

@@ -4,7 +4,7 @@ emoji: 📄
 colorFrom: green
 colorTo: blue
 sdk: gradio
-sdk_version: "4.44.0"
+sdk_version: "4.44.1"
 app_file: app.py
 pinned: false
 license: mit

app.py

@@ -483,9 +483,30 @@ if __name__ == "__main__":
     # Cria e lança a interface
     demo = create_interface()
 
-    demo.queue().launch(
-        server_name="0.0.0.0",
-        server_port=7860,
-        max_file_size=f"{config.MAX_FILE_SIZE_MB}mb",
-        show_error=True,
-    )
+    # Detecta se está em ambiente containerizado (HF Spaces)
+    is_containerized = HAS_SPACES or os.environ.get("SPACE_ID") is not None
+
+    try:
+        demo.queue().launch(
+            server_name="0.0.0.0",
+            server_port=7860,
+            max_file_size=f"{config.MAX_FILE_SIZE_MB}mb",
+            show_error=True,
+            share=is_containerized,  # Habilita link compartilhável em containers
+        )
+    except Exception as e:
+        logger.error(f"Erro ao iniciar aplicação: {e}")
+        logger.info("Tentando iniciar com configuração alternativa...")
+
+        # Fallback: tenta com share=True
+        try:
+            demo.queue().launch(
+                server_name="0.0.0.0",
+                server_port=7860,
+                max_file_size=f"{config.MAX_FILE_SIZE_MB}mb",
+                show_error=True,
+                share=True,
+            )
+        except Exception as fallback_error:
+            logger.critical(f"Falha crítica ao iniciar: {fallback_error}")
+            raise

implementation_plan.md

@@ -0,0 +1,59 @@
+# Implementation Plan
+
+[Overview]
+Fix the Gradio JSON schema TypeError that prevents the Docling Document Processor from starting, caused by a bug in Gradio 4.44.0 when processing boolean schema values.
+
+The application fails to launch due to a TypeError in Gradio's client utils module where the code attempts to iterate over a boolean value when processing JSON schema information. This is a known issue in Gradio 4.44.0 that occurs during API info generation. Additionally, the application encounters localhost accessibility issues in containerized environments.
+
+[Types]
+Update dependency versions and add error handling for schema processing.
+
+The main type system changes involve updating Gradio from 4.44.0 to 4.44.1+ to resolve the JSON schema processing bug, and adding configuration options for shareable links to handle localhost accessibility issues in containerized environments.
+
+[Files]
+Update configuration files and main application entry point.
+
+- **requirements.txt**: Update Gradio version from 4.44.0 to 4.44.1 or higher
+- **app.py**: Add share=True parameter to demo.launch() and implement error handling for container environments
+- **config.py**: Add new configuration constants for shareable links and localhost handling
+- **README.md**: Update documentation with troubleshooting section for common runtime errors
+
+[Functions]
+Modify the application launch function and add error handling.
+
+- **app.py process_documents()**: No changes needed - function is working correctly
+- **app.py create_interface()**: No changes needed - interface creation is working
+- **app.py main block**: Modify demo.launch() call to include share=True parameter and add try-catch for startup errors
+- **New function handle_launch_error()**: Add error handling for containerized environments with fallback options
+
+[Classes]
+No class modifications required - the error is in the Gradio framework, not application classes.
+
+The DoclingProcessor, JSONFormatter, and MarkdownFormatter classes are functioning correctly. The issue is external to the application logic.
+
+[Dependencies]
+Update Gradio framework version to resolve the JSON schema bug.
+
+- **gradio**: Upgrade from 4.44.0 to 4.44.1+ (current latest is 4.44.1)
+- **spaces**: No changes needed - current version is compatible
+- **docling**: No changes needed - current version is working
+- **Additional testing**: Verify all dependencies work with updated Gradio version
+
+[Testing]
+Verify the application starts successfully and handles edge cases.
+
+- **Unit tests**: Run existing test suite to ensure no regressions
+- **Integration tests**: Test file upload and processing functionality
+- **Container tests**: Verify application launches in Docker/containerized environments
+- **Error handling tests**: Test fallback scenarios when localhost is not accessible
+
+[Implementation Order]
+Execute fixes in sequence to resolve the startup error and ensure robust operation.
+
+1. Update requirements.txt to specify Gradio 4.44.1 or higher
+2. Modify app.py main block to add share=True parameter and error handling
+3. Add configuration options in config.py for shareable links
+4. Test the application startup locally
+5. Verify containerized deployment works correctly
+6. Run full test suite to ensure no regressions
+7. Update documentation with troubleshooting information

requirements.txt

@@ -3,7 +3,7 @@
 # =============================================================================
 
 # Framework de interface web
-gradio>=4.44.0
+gradio>=4.44.1
 
 # Processamento de documentos
 docling>=2.31.0