Deploy FreeLLMAPI cloud proxy (prebuilt ghcr image, port 7860, /data db)

Dockerfile

@@ -0,0 +1,24 @@
+FROM ghcr.io/tashfeenahmed/freellmapi:latest
+
+# HF Spaces runs containers as UID 1000 and expects the app on port 7860.
+# The base image already runs as `node` (uid 1000) via its entrypoint,
+# so this stays compatible. We only remap port + DB path and fix perms.
+USER root
+RUN mkdir -p /data && chmod 777 /data \
+ && mkdir -p /app/server/data && chown -R node:node /app/server/data || true
+
+ENV NODE_ENV=production \
+    PORT=7860 \
+    HOST=:: \
+    FREELLMAPI_INSTALL_METHOD=docker \
+    FREEAPI_DB_PATH=/data/freellmapi.db
+
+EXPOSE 7860
+
+# Keep upstream entrypoint (fixes perms, then drops to `node`).
+# Runs as root when possible so the entrypoint can chown /data;
+# HF Spaces executes containers as UID 1000 — the entrypoint detects
+# non-root and just execs the server directly (works since /data is 777).
+USER root
+
+CMD ["node", "server/dist/index.js"]

README.md

@@ -1,10 +1,43 @@
 ---
-title: Freellmapi Cloud
-emoji: 💻
-colorFrom: blue
-colorTo: gray
+title: FreeLLMAPI Cloud Proxy
+emoji: 🔌
+colorFrom: indigo
+colorTo: purple
 sdk: docker
+app_port: 7860
 pinned: false
+short_description: FreeLLMAPI — one OpenAI-compatible endpoint
+tags:
+  - llm
+  - openai-compatible
+  - proxy
+  - freellmapi
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# FreeLLMAPI — Cloud Proxy on Hugging Face Spaces
+
+This Space runs [tashfeenahmed/freellmapi](https://github.com/tashfeenahmed/freellmapi) from the prebuilt image
+`ghcr.io/tashfeenahmed/freellmapi:latest` — **no local clone, no local disk used**.
+
+- Dashboard + API on port `7860` (HF requirement)
+- SQLite DB at `/data/freellmapi.db` (ephemeral — see persistence note)
+- Secrets (`ENCRYPTION_KEY`, admin config) are set in **Space → Settings → Variables and secrets**, never committed here.
+
+## Endpoints
+
+- Dashboard: `https://<your-space>.hf.space/`
+- Health: `https://<your-space>.hf.space/api/ping`
+- OpenAI-compatible: `https://<your-space>.hf.space/v1/chat/completions`
+
+```bash
+curl https://<your-space>.hf.space/v1/chat/completions \
+  -H "Authorization: Bearer freellmapi-YOUR-UNIFIED-KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"model":"auto","messages":[{"role":"user","content":"Say hello from FreeLLMAPI."}]}'
+```
+
+## First-run setup
+
+1. Open the Space URL, create the first dashboard account (or pre-create via `FREEAPI_CONFIG_JSON`, see below).
+2. Go to **Keys** page → add provider keys → reorder **Fallback Chain**.
+3. Copy your unified `freellmapi-...` key from the Keys page header → point any OpenAI SDK at the Space URL.