Back to the catalog

Discrete Structures

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
Finance & crypto
Publisher
zohaibcodez
Origin
official
Category
ferramentas
Transport
local
Version
0.1.4
Stars
1
Last push
2026-01-10T13:45:41Z
Repository state
ativo
Language
TypeScript
Added
2026-08-29 03:02:21
Updated
2026-08-29 03:02:21
Origin id
io.github.ZohaibCodez/discrete-structures

README

# 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

```
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.

More