02 of 05
Clarift
AI-powered study engine for Filipino students — transforms uploaded materials into summaries, quizzes, and targeted practice
2026Sole Full Stack Developer
Primary visual evidence
Brief
Problem
Filipino students and review center learners waste hours reformatting raw study material into usable review content. Existing tools either ignore uploaded notes or generate content from general knowledge rather than the student's own materials.
Response
Clarift is an AI-powered study engine built specifically for Filipino students and review center learners. It transforms uploaded study material into structured summaries, quizzes, and targeted practice through an active learning loop designed for high-stakes exams. The system uses RAG to ground all AI outputs in the student's own notes, never generating from general knowledge.
Technical Decisions
- 01
Split architecture (Next.js frontend + FastAPI backend): AI pipelines need persistent processes with proper task isolation, serverless functions hit timeout limits for LangChain chains.
- 02
ARQ worker with Redis queue: async job processing for document ingestion and AI generation keeps the API responsive and allows SSE progress tracking.
- 03
pgvector for embeddings: leverages the existing Neon PostgreSQL database rather than adding a separate vector store, reducing infrastructure complexity.
- 04
Clerk for auth with JWT verification in FastAPI: OAuth handled by a dedicated service, backend verifies tokens directly for tenant isolation.
- 05
Cloudflare R2 for file storage: S3-compatible, cost-effective for PDF uploads without vendor lock-in.
System
Stack
- 01Next.js 16
- 02React 19
- 03TypeScript
- 04Tailwind CSS 4
- 05shadcn/ui
- 06Radix UI
- 07Framer Motion
- 08TanStack React Query
- 09Zustand
- 10Tiptap
- 11Recharts
- 12FastAPI
- 13Python 3.12
- 14LangChain
- 15SQLAlchemy async
- 16Alembic
- 17Neon PostgreSQL
- 18pgvector
Integrations
- 01Clerk
- 02Google Gemini API
- 03Cloudflare R2
- 04Upstash Redis
- 05PayMongo
- 06Sentry
- 07Vercel
- 08Railway
Capabilities
- 01Document ingestion — upload PDFs as study material
- 02Structured summaries — multi-step AI chain with MermaidJS diagrams
- 03Quiz generation — auto-generated from uploaded material only
- 04Weak area diagnosis — identifies knowledge gaps from quiz performance
- 05Targeted practice — personalized drills focused on specific weak topics
- 06Grounded RAG chat — answers exclusively from uploaded notes
- 07Quota system — daily usage limits with free and Pro tiers
Screenshots
