Merge branch 'main' of https://huggingface.co/spaces/dpv007/KeyStone

Dockerfile

@@ -0,0 +1,39 @@
+FROM node:20 AS frontend
+
+WORKDIR /frontend
+
+COPY mobile/package.json ./
+RUN npm install
+
+COPY mobile/ .
+RUN npx expo export --platform web
+
+FROM python:3.11-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libmagic1 \
+    libmagic-dev \
+    libjpeg-dev \
+    zlib1g-dev \
+    libwebp-dev \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY backend/requirements.txt ./requirements.txt
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir -r requirements.txt
+
+COPY backend/ .
+COPY --from=frontend /frontend/dist ./web
+
+RUN useradd -m -u 1000 appuser && chown -R appuser:appuser /app
+USER appuser
+
+EXPOSE 7860
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=10s --retries=3 \
+    CMD curl -f http://localhost:7860/health || exit 1
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "2"]

README.md

@@ -0,0 +1,117 @@
+---
+title: KeyStone Photo Cloud
+emoji: 🔷
+colorFrom: purple
+colorTo: indigo
+sdk: docker
+app_port: 7860
+pinned: false
+license: mit
+---
+
+# KeyStone 🔷 – Private Photo Cloud
+
+> Your photos. Your cloud. Zero dependencies on Google or Apple.
+
+KeyStone is a self-hosted Google Photos alternative with automatic mobile backup, deduplication, and AI-ready architecture.
+
+## Architecture
+
+```
+Expo App (iOS + Android + Web)
+         │
+   Supabase Auth (JWT)
+         │
+   FastAPI Backend  ─────► Hugging Face Bucket (storage)
+         │
+   Supabase PostgreSQL
+```
+
+## Live Deployment
+
+| Service | URL |
+|---|---|
+| 🚀 Backend API | https://dpv007-keystone.hf.space |
+| 📖 API Docs | https://dpv007-keystone.hf.space/docs |
+
+## Quick Start
+
+### Backend (local dev)
+
+```bash
+cd backend
+cp .env.example .env       # fill in your credentials
+docker compose up          # starts FastAPI + PostgreSQL
+```
+
+### Run database migrations
+
+```bash
+cd backend
+alembic upgrade head
+```
+
+### Mobile App
+
+```bash
+cd mobile
+cp .env.example .env       # fill in Supabase keys
+npm install
+npm start                  # Expo dev server (iOS/Android/Web)
+```
+
+Open in browser: http://localhost:8081 (web), or scan QR in Expo Go.
+
+## Environment Variables
+
+### Backend (`backend/.env`)
+
+| Variable | Description |
+|---|---|
+| `DATABASE_URL` | Supabase PostgreSQL connection string |
+| `SUPABASE_URL` | Your Supabase project URL |
+| `SUPABASE_JWT_SECRET` | JWT secret from Supabase Dashboard → Settings → API |
+| `HF_TOKEN` | Hugging Face token with write access |
+| `HF_DATASET_REPO` | HF Dataset repo for photo storage (e.g. `user/keystone-photos`) |
+
+### Mobile (`mobile/.env`)
+
+| Variable | Description |
+|---|---|
+| `EXPO_PUBLIC_API_URL` | Backend URL (defaults to HF Space URL) |
+| `EXPO_PUBLIC_SUPABASE_URL` | Your Supabase project URL |
+| `EXPO_PUBLIC_SUPABASE_ANON_KEY` | Supabase anon key |
+
+## Features
+
+- ✅ Email/password authentication via Supabase
+- ✅ JWT verification on every API request
+- ✅ SHA256 deduplication (never upload the same photo twice)
+- ✅ Background sync (iOS + Android) with Wi-Fi-only option
+- ✅ Battery-aware syncing
+- ✅ Thumbnail generation (Pillow)
+- ✅ Infinite-scroll gallery
+- ✅ Albums with photo management
+- ✅ Photo search (filename + AI tags)
+- ✅ Favorites
+- ✅ Soft delete
+- ✅ Works on iOS, Android, and Web (same codebase)
+- 🔜 CLIP semantic search
+- 🔜 Face clustering
+- 🔜 OCR text extraction
+- 🔜 Auto albums
+
+## Deployment to Hugging Face Spaces
+
+The backend is a Docker Space. Push this repo and set the following secrets in the Space settings:
+
+- `DATABASE_URL`
+- `SUPABASE_URL`
+- `SUPABASE_JWT_SECRET`
+- `SUPABASE_SERVICE_ROLE_KEY`
+- `HF_TOKEN`
+- `HF_DATASET_REPO`
+
+## License
+
+MIT