io.github.ZohaibCodez/discrete-structures

Official

by ZohaibCodez · TypeScript

Discrete Structures

Comprehensive tools for discrete mathematics: logic, algorithms, number theory, cryptography

Tools for discrete mathematics including logic, algorithms, number theory, and cryptography.

Topics

ai-chatbotalgorithm-visualizerboolean-algebracryptographydiscrete-mathematicsdiscrete-structuresgraph-theorymcpmodel-context-protocolnumber-theoryopenai-agents-sdk

README.md2 KBView on GitHub

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

bash

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

bash

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

Frontend runs on http://localhost:5173

Project Structure

code

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.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "discrete-structures": {
      "command": "uvx",
      "args": [
        "discrete-structures-mcp"
      ]
    }
  }
}