Refactor Dockerfile to create Streamlit configuration directly

- Removed the copy of the .streamlit directory and replaced it with a RUN command to generate the Streamlit config file within the Dockerfile.
- Configured various Streamlit settings for production use, including server settings and theme customization.

Dockerfile

@@ -16,7 +16,27 @@ RUN mkdir -p /app/.streamlit /tmp/docling_temp && \
 
 COPY requirements.txt ./
 COPY src/ ./src/
-COPY .streamlit/ ./.streamlit/
+
+# Create Streamlit config directly in Dockerfile to avoid copy issues
+RUN echo '[global]' > /app/.streamlit/config.toml && \
+    echo 'developmentMode = false' >> /app/.streamlit/config.toml && \
+    echo '' >> /app/.streamlit/config.toml && \
+    echo '[server]' >> /app/.streamlit/config.toml && \
+    echo 'fileWatcherType = "none"' >> /app/.streamlit/config.toml && \
+    echo 'headless = true' >> /app/.streamlit/config.toml && \
+    echo 'enableCORS = false' >> /app/.streamlit/config.toml && \
+    echo 'enableXsrfProtection = false' >> /app/.streamlit/config.toml && \
+    echo '' >> /app/.streamlit/config.toml && \
+    echo '[browser]' >> /app/.streamlit/config.toml && \
+    echo 'gatherUsageStats = false' >> /app/.streamlit/config.toml && \
+    echo 'serverAddress = "0.0.0.0"' >> /app/.streamlit/config.toml && \
+    echo 'serverPort = 8501' >> /app/.streamlit/config.toml && \
+    echo '' >> /app/.streamlit/config.toml && \
+    echo '[theme]' >> /app/.streamlit/config.toml && \
+    echo 'primaryColor = "#1f77b4"' >> /app/.streamlit/config.toml && \
+    echo 'backgroundColor = "#ffffff"' >> /app/.streamlit/config.toml && \
+    echo 'secondaryBackgroundColor = "#f0f2f6"' >> /app/.streamlit/config.toml && \
+    echo 'textColor = "#262730"' >> /app/.streamlit/config.toml
 
 RUN pip3 install -r requirements.txt
 

TROUBLESHOOTING.md

@@ -0,0 +1,71 @@
+# Troubleshooting Guide
+
+## Hugging Face Deployment Issues
+
+### Permission Errors
+
+If you encounter permission errors like:
+```
+PermissionError: [Errno 13] Permission denied: 'temp_files'
+```
+
+The app has been updated to handle these automatically by:
+1. Using system temp directories (`/tmp/docling_temp`)
+2. Falling back to current working directory
+3. Using current directory as last resort
+
+### Streamlit Configuration Issues
+
+If you see errors related to Streamlit configuration:
+```
+PermissionError: [Errno 13] Permission denied: '/.streamlit'
+```
+
+The app now:
+1. Disables usage statistics collection
+2. Uses headless mode
+3. Disables file watcher
+4. Uses proper configuration files
+
+### Testing the Environment
+
+You can test if the environment is working correctly by running:
+
+```bash
+python test_permissions.py
+```
+
+This will check:
+- Directory creation permissions
+- File write permissions
+- Environment variable configuration
+- Current directory access
+
+### Common Solutions
+
+1. **Clear all data**: Use the "Clear All Data" button in the app
+2. **Restart the app**: Sometimes a simple restart fixes permission issues
+3. **Check logs**: Look for detailed error messages in the app logs
+
+### Environment Variables
+
+The app automatically sets these environment variables:
+- `STREAMLIT_SERVER_FILE_WATCHER_TYPE=none`
+- `STREAMLIT_SERVER_HEADLESS=true`
+- `STREAMLIT_BROWSER_GATHER_USAGE_STATS=false`
+- `STREAMLIT_SERVER_ENABLE_CORS=false`
+- `STREAMLIT_SERVER_ENABLE_XSRF_PROTECTION=false`
+
+### File Structure
+
+The app creates these directories:
+- `.streamlit/` - Streamlit configuration
+- `temp_files/` or `/tmp/docling_temp/` - Temporary files
+- `src/` - Application source code
+
+### Docker Configuration
+
+The Dockerfile has been updated to:
+- Create necessary directories with proper permissions
+- Copy Streamlit configuration files
+- Set up proper environment variables