--- title: PDF Tokenizer emoji: 🧩 colorFrom: blue colorTo: red sdk: docker pinned: false --- # PDF Token Splitter (Hugging Face Space Ready) This repository is packaged to run as a **Docker Space** on Hugging Face. ## How it works - Single container runs FastAPI backend and serves the built frontend (Vite) as static files. - API endpoints are under the same origin; no CORS setup needed on Spaces. - Uploads are processed in-memory; results are zipped and downloadable. Jobs auto-expire after 15 minutes. ## Deploy on Hugging Face Spaces (Free) 1. Create a new Space → **Type: Docker** → **Hardware: CPU Basic**. 2. Push this repository (connect GitHub or upload as a ZIP). 3. The Space builds using the **Dockerfile** at repo root. 4. Once started, your app is available at the Space URL. ## Local dev - Frontend: `cd frontend && npm install && npm run dev` - Backend: `cd backend && uvicorn main:app --host 0.0.0.0 --port 8000`