Update Dockerfile, README, routes, main.py, add app.py and expose

Dockerfile

@@ -1,7 +1,8 @@
 FROM python:3.12-slim
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1
+    PYTHONUNBUFFERED=1 \
+    PORT=7860
 
 WORKDIR /app
 
@@ -10,5 +11,5 @@ RUN pip install --no-cache-dir -r requirements.txt
 
 COPY . .
 
-EXPOSE 8000
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
+EXPOSE 7860
+CMD ["python", "app.py"]

README.md

@@ -155,6 +155,27 @@ Mounts the current directory with hot-reload enabled.
 
 ---
 
+## Hugging Face Spaces
+
+This repository is prepared to run as a Hugging Face Space using the top-level `app.py` entrypoint.
+
+### What to do in Hugging Face
+
+1. Create a new Space with the Python template.
+2. Connect this repository to the Space.
+3. Configure the required secrets in the Space settings if you want the full backend features enabled.
+4. Deploy.
+
+The Space will expose the FastAPI app on port `7860` and the app will respond at:
+
+- `/` — simple service overview
+- `/healthz` — health check
+- `/docs` — interactive API documentation
+
+If the external services are not configured yet, the app still starts in a lightweight demo mode and serves the health endpoint.
+
+---
+
 ## WhatsApp Baileys Bridge
 
 FALZH uses the official Meta Cloud API for production messages. During early stages — while waiting for commercial approval — a **Baileys-based bridge** acts as the WhatsApp gateway.

app.py

@@ -0,0 +1,10 @@
+import os
+
+import uvicorn
+
+from main import app as falzh_app
+
+
+if __name__ == "__main__":
+    port = int(os.environ.get("PORT", "7860"))
+    uvicorn.run(falzh_app, host="0.0.0.0", port=port, log_level="info")

app/api/routes.py

@@ -33,8 +33,16 @@ import json
 router = APIRouter()
 
 
+@router.get("/", include_in_schema=False)
+async def root() -> dict[str, str]:
+    return {"service": "FALZH", "status": "ready", "docs": "/docs"}
+
+
 @router.get("/healthz", response_model=HealthResponse)
-async def healthz(container: Annotated[ServiceContainer, Depends(get_container)]) -> HealthResponse:
+async def healthz(request: Request) -> HealthResponse:
+    container = getattr(request.app.state, "container", None)
+    if container is None:
+        return HealthResponse(service="FALZH (demo mode)")
     return HealthResponse(service=container.settings.app_name)
 
 

app/main.py

@@ -16,9 +16,31 @@ def create_app(
 ) -> FastAPI:
     @asynccontextmanager
     async def lifespan(app: FastAPI) -> AsyncIterator[None]:
-        active_settings = settings or (container.settings if container else get_settings())
-        configure_logging(active_settings.log_level)
-        app.state.container = container or await ServiceContainer.from_settings(active_settings)
+        app.state.container = None
+        app.state.container_init_error = None
+
+        if container is not None:
+            active_settings = container.settings
+            app.state.container = container
+        else:
+            try:
+                active_settings = settings or get_settings()
+            except Exception as exc:  # pragma: no cover - defensive startup path
+                active_settings = None
+                app.state.container_init_error = str(exc)
+
+        if active_settings is not None:
+            configure_logging(active_settings.log_level)
+        else:
+            configure_logging("INFO")
+
+        if container is None and active_settings is not None:
+            try:
+                app.state.container = await ServiceContainer.from_settings(active_settings)
+            except Exception as exc:  # pragma: no cover - defensive startup path
+                app.state.container = None
+                app.state.container_init_error = str(exc)
+
         yield
 
     app = FastAPI(title="FALZH API", version="0.1.0", lifespan=lifespan)