Add initial implementation of Yantrabodha Article API with FastAPI and Supabase integration

Dockerfile

@@ -0,0 +1,18 @@
+# Hugging Face Spaces — FastAPI app (Yantrabodha API)
+# Runs from repo root; app code lives in api/
+
+FROM python:3.12-slim
+
+RUN useradd -m -u 1000 user
+USER user
+ENV HOME=/home/user PATH=/home/user/.local/bin:$PATH
+WORKDIR $HOME/app
+
+COPY --chown=user api/requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY --chown=user api/ .
+
+# HF Spaces expose port 7860 by default
+EXPOSE 7860
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

api/.env

@@ -0,0 +1,3 @@
+# Supabase — Project Settings → API
+SUPABASE_URL=https://kdtbcdsugebjjxtufsiy.supabase.co
+SUPABASE_SERVICE_KEY=sb_publishable__iDn02CEPpNdGShqBinK0Q_7tgniGQf

api/database.py

@@ -0,0 +1,9 @@
+"""Supabase client singleton."""
+import os
+
+from supabase import create_client, Client
+
+SUPABASE_URL = os.environ["SUPABASE_URL"]
+SUPABASE_SERVICE_KEY = os.environ["SUPABASE_SERVICE_KEY"]
+
+supabase: Client = create_client(SUPABASE_URL, SUPABASE_SERVICE_KEY)

api/endpoints/__init__.py

@@ -0,0 +1,5 @@
+"""API endpoint routers."""
+from .match import router as match_router
+from .post import router as post_router
+
+__all__ = ["post_router", "match_router"]

api/endpoints/match.py

@@ -0,0 +1,30 @@
+"""MATCH endpoint — full-text search across articles."""
+from typing import Optional
+
+from fastapi import APIRouter, Query
+
+from database import supabase
+
+router = APIRouter(tags=["match"])
+
+
+@router.get("")
+def match_articles(
+    q: str = Query(..., min_length=1, description="Search query"),
+    language: Optional[str] = Query(None, description="Filter by language"),
+    type: Optional[str] = Query(None, description="Filter by type"),
+    limit: int = Query(5, ge=1, le=50, description="Max results"),
+):
+    """Full-text search across article titles and bodies."""
+    query = (
+        supabase.table("articles")
+        .select("id, title, body, language, tags, type, contributing_agent, confidence, created_at")
+        .text_search("fts", q, config="english")
+        .limit(limit)
+    )
+    if language:
+        query = query.eq("language", language)
+    if type:
+        query = query.eq("type", type)
+    result = query.execute()
+    return result.data

api/endpoints/post.py

@@ -0,0 +1,21 @@
+"""POST endpoint — submit a new article."""
+from fastapi import APIRouter, HTTPException
+
+from database import supabase
+from models import ArticleIn, ArticleOut
+
+router = APIRouter(tags=["post"])
+
+
+@router.post("", response_model=ArticleOut, status_code=201)
+def create_article(article: ArticleIn):
+    """Insert a new article into the knowledge base."""
+    result = (
+        supabase.table("articles")
+        .insert(article.model_dump())
+        .execute()
+    )
+    if not result.data:
+        raise HTTPException(status_code=500, detail="Failed to insert article")
+    row = result.data[0]
+    return ArticleOut(id=row["id"], title=row["title"], created_at=row["created_at"])

api/main.py

@@ -0,0 +1,22 @@
+"""
+Yantrabodha Article API
+=======================
+FastAPI app backed by Supabase (Postgres). Endpoints:
+  - POST /post   — submit a new article
+  - GET  /match  — full-text search across articles
+
+Environment variables:
+  SUPABASE_URL         — from Supabase Project Settings → API
+  SUPABASE_SERVICE_KEY — service role key (bypasses RLS)
+"""
+
+from fastapi import FastAPI
+
+from database import supabase  # noqa: F401 — ensure DB is loaded
+from endpoints.match import router as match_router
+from endpoints.post import router as post_router
+
+app = FastAPI(title="Yantrabodha API", version="1.0.0")
+
+app.include_router(post_router, prefix="/post")
+app.include_router(match_router, prefix="/match")

api/models.py

@@ -0,0 +1,20 @@
+"""Shared Pydantic models for the API."""
+from typing import Optional
+
+from pydantic import BaseModel
+
+
+class ArticleIn(BaseModel):
+    title: str
+    body: str
+    language: str = "general"
+    tags: list[str] = []
+    type: str = "error"
+    contributing_agent: Optional[str] = None
+    confidence: str = "medium"
+
+
+class ArticleOut(BaseModel):
+    id: str
+    title: str
+    created_at: str

api/requirements.txt

@@ -0,0 +1,4 @@
+fastapi
+uvicorn
+supabase
+pydantic