This project simulates how an Operating System enforces strict memory isolation between processes to prevent unauthorized access and data leakage. It features a complete FastAPI Python backend for the OS kernel simulation and a modern React + Tailwind + Framer Motion dashboard.
backend/: Python FastAPI app containing the OS Simulation Engine (Memory Manager, Process Manager, Access Matrix).frontend/: React + Vite + Tailwind project containing the cyberpunk dashboard.
- Python 3.9+
- Node.js 18+
- Open a terminal and navigate to the
backendfolder:cd backend - Create and activate a virtual environment:
python -m venv venv # On Windows: .\venv\Scripts\activate # On Mac/Linux: source venv/bin/activate
- Install the dependencies:
pip install fastapi uvicorn websockets pydantic
- Open a terminal and navigate to the
frontendfolder:cd frontend - Install the dependencies:
npm install
In the backend folder (with the virtual environment activated), run:
uvicorn main:app --reload --port 8000The simulation engine will start on ws://localhost:8000/ws.
In the frontend folder, run:
npm run devOpen the provided local URL (usually http://localhost:5173) in your browser.
- Memory Visualization: Watch RAM frames get allocated in real-time.
- Process Manager: Spawn and terminate simulated processes.
- Access Control: View the Matrix dictating which process can access which memory frame.
- Threat Simulation: Test Buffer Overflows and Unauthorized Cross-Process reads, watching the system raise SIGSEGV and terminate offending processes!