Discrete Structures AI Learning Platform

An interactive web-based educational platform for learning discrete structures through visualizations, AI-powered assistance, and hands-on tools.

Features

• Algorithm Visualizer: Step-by-step animations of sorting and searching algorithms
• Cryptography Playground: Explore classical and modern encryption techniques
• Logic Calculator: Boolean algebra, truth tables, and expression simplification
• Number Theory Explorer: Prime numbers, GCD/LCM, modular arithmetic tools
• AI Chatbot Assistant: Get help with discrete structures concepts via AI

Tech Stack

• Backend: Python 3.11+, FastAPI, OpenAI Agents SDK, MCP Protocol
• Frontend: React 18, TypeScript, Vite, TailwindCSS, Framer Motion
• Package Management: uv (Python), npm (JavaScript)

Quick Start

Prerequisites

• Python 3.11 or higher
• Node.js 18 or higher
• uv package manager (pip install uv)
• OpenAI API key

Backend Setup

cd backend
uv sync
copy .env.example .env
# Edit .env and add your OPENAI_API_KEY
uv run uvicorn src.main:app --reload

Backend runs on http://localhost:8000

Frontend Setup

cd frontend
npm install
copy .env.example .env
npm run dev

Frontend runs on http://localhost:5173

Project Structure

discrete-structures-ai-platform/
├── backend/          # FastAPI backend + MCP server
│   ├── src/
│   │   ├── api/      # API endpoints
│   │   ├── agents/   # OpenAI agents
│   │   ├── mcp/      # MCP tools
│   │   ├── models/   # Pydantic models
│   │   └── services/ # Business logic
│   └── tests/        # Backend tests
├── frontend/         # React frontend
│   ├── src/
│   │   ├── components/  # React components
│   │   ├── pages/       # Page components
│   │   ├── services/    # API clients
│   │   ├── hooks/       # Custom hooks
│   │   └── types/       # TypeScript types
│   └── public/       # Static assets
└── specs/            # Project specifications

Development

This project follows a phased implementation approach:

• Phase 1: Project Setup ✅
• Phase 2: Foundational Infrastructure ✅
• Phase 3: Landing Page ✅
• Phase 4+: Feature implementation (in progress)

See specs/001-ds-ai-platform/tasks.md for detailed task breakdown.

License

Educational use only.