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 --reloadBackend runs on http://localhost:8000
Frontend Setup
cd frontend
npm install
copy .env.example .env
npm run devFrontend 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 specificationsDevelopment
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.
