Clarity for Every Concept. Where Knowledge Becomes Insight.

Features • Tech Stack • Support

Academic Oracle

Academic Oracle is a learning-focused AI platform designed to maximize understanding, not passive consumption.

Instead of immediately giving answers, Academic Oracle follows a scientifically grounded flow:

Ask → Think → Hint → Pattern → Insight

The goal is not memorization — it’s deep, durable learning.

---

Why Academic Oracle?

Most AI tools optimize for speed.
Academic Oracle optimizes for retention, intuition, and reasoning.

Core Learning Principles

• Active recall before answers
• Progressive hinting instead of instant solutions
• Pattern discovery over rote explanation
• Minimal UI disruption to maintain cognitive flow

You don’t just learn faster — you learn properly.

---

Features

• 🧠 Hint-based reasoning flow (ask first, reveal later)
• 🧮 Robust Markdown rendering
  • Math (KaTeX)
  • Tables
  • Code blocks
• 🎨 Dark / Light mode
• 🔐 AES-GCM-256 encryption for API key storage
• 🧩 Arcade-style onboarding tutorial
• 👤 User profile & session continuity
• 🖥️ Responsive UI (desktop & mobile)
• 🛑 Fail-in-console design (errors never break the UI)
• ☕ Buy Me a Coffee support link

---

Tech Stack

• Frontend: React + TypeScript
• Styling: Tailwind CSS
• Math Rendering: KaTeX
• State & UX: Custom lightweight logic (no heavy frameworks)
• Security: AES-GCM-256 encryption for sensitive keys
• AI Provider: Gemini API (user-supplied key)

---

Running Locally

Prerequisites

• Node.js (v18+ recommended)

Setup

1. Install dependencies:

   npm install
   

2. Setup Environment Variables:

   VITE_SUPABASE_URL=YOUR_SUPABASE_URL
   VITE_SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY
   
   

3. Start development server:

   npm run dev
   

API Key will be asked during initial signup for an account

Support

If Academic Oracle helps your learning:

• ⭐ Star the repository

• ☕ Support via Buy Me a Coffee

• 🧠 Use it, break it, and learn from it

Recognition means a lot — but impact matters more.