Files Added

Dockerfile.txt

@@ -0,0 +1,25 @@
+# Use the official Python slim image for a lightweight base
+FROM python:3.10-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements file
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY app.py .
+
+# Expose port 7860 (default for Hugging Face Spaces)
+EXPOSE 7860
+
+# Command to run the FastAPI app with uvicorn
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -8,4 +8,40 @@ pinned: false
 short_description: Quotes API Space
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Quotes API Space
+
+This Hugging Face Space provides an API to fetch 50 random quotes from the [jstet/quotes-500k](https://huggingface.co/datasets/jstet/quotes-500k) dataset.
+
+## Usage
+
+Send a GET request to `/api/quotes` to retrieve 50 random quotes. Example response:
+
+```json
+{
+  "quotes": [
+    {"quote": "Life is what happens when you're busy making other plans.", "author": "John Lennon", "category": "Life"},
+    ...
+  ]
+}
+```
+
+## Setup
+
+This Space uses the Docker Space SDK with Python, FastAPI, and the Hugging Face `datasets` library. The configuration is defined in the following files:
+
+- `Dockerfile`: Defines the Docker image.
+- `requirements.txt`: Lists Python dependencies.
+- `app.py`: Contains the FastAPI application code.
+
+## Deployment
+
+To deploy this Space on Hugging Face:
+
+1. Create a new Space on Hugging Face, selecting the Docker template.
+2. Upload the `Dockerfile`, `requirements.txt`, `app.py`, and `README.md` files to the Space repository.
+3. Configure the Space to use the Docker Space SDK.
+4. Build and deploy the Space.
+
+The Space will be available at `https://<your-username>-<space-name>.hf.space/api/quotes`.
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -0,0 +1,18 @@
+from fastapi import FastAPI
+from datasets import load_dataset
+import pandas as pd
+import random
+
+app = FastAPI()
+
+# Load the dataset once at startup
+dataset = load_dataset("jstet/quotes-500k")
+quotes_df = dataset["train"].to_pandas()
+
+@app.get("/api/quotes")
+async def get_random_quotes():
+    # Sample 50 random quotes
+    random_quotes = quotes_df.sample(n=50, random_state=random.randint(1, 100000))
+    # Convert to list of dictionaries for JSON response
+    quotes_list = random_quotes[["quote", "author", "category"]].to_dict(orient="records")
+    return {"quotes": quotes_list}

requirements.txt

@@ -0,0 +1,4 @@
+fastapi==0.115.0
+uvicorn==0.32.0
+datasets==3.0.1
+pandas==2.2.3