surya-shiksha

SURYA SHIKSHA ☀️

AI-Powered Agentic Learning Operating System built with Next.js 14, Prisma, NextAuth, and OpenAI GPT-4o.

Architecture Overview

Project Structure

Local Setup

  1. Install dependencies:
    npm install
    
  2. Copy env file:
    cp .env.example .env
    
  3. Start PostgreSQL (local or Docker):
    docker compose up -d postgres
    
  4. Generate Prisma client + migrate:
    npx prisma generate
    npx prisma migrate dev --name init
    
  5. Seed demo data:
    npm run seed
    
  6. Run app:
    npm run dev
    

Demo Users (password: demo123)

Docker Deployment

docker compose up --build

App: http://localhost:3000

Vercel Deployment

  1. Import repository in Vercel.
  2. Set environment variables (DATABASE_URL, OPENAI_API_KEY, NEXTAUTH_SECRET, NEXTAUTH_URL).
  3. Build command already configured in vercel.json:
    • prisma generate && next build
  4. Deploy.

CI

GitHub Actions workflow (.github/workflows/ci.yml) performs:


Author & Enterprise AI Architecture Hub

Built by Nagarjuna Reddy Kamireddy (Nagarjuna Kamireddy / Nagarjuna K) — Lead AI Architect, GenAI & Agentic AI Lead, and Corporate AI Trainer (20+ years across Enterprise Data, SAP HANA & Production AI; AWS Certified Solutions Architect – Professional & NVIDIA-Certified Professional: Agentic AI).