HF spaces deployment #182654

Saadajee420 · 2025-12-24T17:20:37Z

Saadajee420
Dec 24, 2025

I succesfully did everything managed to run the FASTAPI backend using docker container on HF spcaes but it kept getting stuck on starting and not moving on, stuck for 30 minutes and then closed by HF spaces. Any idea on how to resolve that?

Saadajee · 2025-12-24T17:26:02Z

Saadajee
Dec 24, 2025

Well, it seems as the HF space starts but it dont know how to go forward from there. To tackle that problem u can check ur docker exposed port and startup.sh port for the FastAPI backend. Another thing is the main.py in the backend folder, locally it can deploy with no issues but on HF spaces it requires a special API to load the HTML page. It goes like

# Simple root endpoint - this is the key fix for HF Spaces "Starting" issue
@app.get("/", response_class=responses.HTMLResponse)
def root():
    return """
    <html>
        <head>
            <title>Socrates RAG Backend</title>
            <style>
                body { font-family: system-ui, sans-serif; margin: 40px; background: #f9f9f9; line-height: 1.6; }
                a { color: #0066cc; }
                pre { background: #eee; padding: 10px; border-radius: 6px; }
            </style>
        </head>
        <body>
            <h1>Socrates Chatbot API is Running</h1>
            <p>Backend is healthy and ready.</p>
            <ul>
                <li>Interactive API documentation: <a href="/docs" target="_blank">Swagger UI (/docs)</a></li>
                <li>Alternative docs: <a href="/redoc" target="_blank">ReDoc (/redoc)</a></li>
                <li>Health check: <a href="/health">/health</a></li>
            </ul>
            <p><strong>Frontend</strong> is hosted separately on Vercel and connects to this API.</p>
            <hr>
            <small>Deployed on Hugging Face Spaces</small>
        </body>
    </html>
    """

Worked like a charm for me. And started the backend successfully.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

GitHub Community

HF spaces deployment #182654

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

GitHub Community

HF spaces deployment #182654

Uh oh!

Saadajee420 Dec 24, 2025

Replies: 1 comment

Uh oh!

Saadajee Dec 24, 2025

Saadajee420
Dec 24, 2025

Saadajee
Dec 24, 2025