https://github.com/roastedbeans/5g-network-simulator
A comprehensive web-based 5G network simulator offering interactive visualization of network functions and protocols built with Next.js, HeroUI, D3.js, and Mermaid for engineers, researchers, and students to understand, test, and optimize mobile network performance.
https://github.com/roastedbeans/5g-network-simulator
Last synced: about 1 month ago
JSON representation
A comprehensive web-based 5G network simulator offering interactive visualization of network functions and protocols built with Next.js, HeroUI, D3.js, and Mermaid for engineers, researchers, and students to understand, test, and optimize mobile network performance.
- Host: GitHub
- URL: https://github.com/roastedbeans/5g-network-simulator
- Owner: roastedbeans
- Created: 2025-04-21T04:10:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-02T01:58:37.000Z (4 months ago)
- Last Synced: 2026-02-02T11:36:16.151Z (4 months ago)
- Language: TypeScript
- Homepage: https://roaming-ui.vercel.app
- Size: 578 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 5G Network Simulator
A comprehensive visualization and simulation tool for 5G network architecture, protocols, and security mechanisms.
## Features
- **Network Visualization**: Interactive visualization of 5G network functions and their connections using D3.js
- **Protocol Simulation**: Simulate key 5G protocols including authentication and session establishment
- **Security Analysis**: Analyze and understand 5G security mechanisms and key hierarchies
- **Real-time Messaging**: Visualize message passing between network functions
## Tech Stack
- **Frontend**: Next.js (App Router), TypeScript, TailwindCSS
- **Visualization**: D3.js for network visualization, Mermaid for protocol diagrams
- **Database**: MongoDB/Mongoose for data persistence
- **Backend**: RESTful APIs built with Next.js API routes
## Project Structure
```
5g-simulator/
├── src/
│ ├── app/ # Next.js app router
│ ├── components/ # Reusable UI components
│ │ ├── network/ # Network visualization components
│ │ ├── protocol/ # Protocol visualization components
│ │ └── ui/ # General UI components
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions and shared code
│ ├── models/ # MongoDB schema definitions
│ ├── services/ # Business logic and API integrations
│ │ ├── simulator/ # 5G network simulation services
│ │ └── security/ # Security protocol services
│ └── types/ # TypeScript type definitions
└── public/ # Static assets
```
## Getting Started
### Prerequisites
- Node.js 18+
- npm or yarn
- MongoDB (optional for full functionality)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/your-username/5g-simulator.git
cd 5g-simulator
```
2. Install dependencies:
```bash
npm install
```
3. Run the development server:
```bash
npm run dev
```
4. Open [http://localhost:3000](http://localhost:3000) in your browser to see the application.
## Simulated 5G Protocols
The simulator demonstrates several key 5G protocols:
1. **5G-AKA Authentication**: The authentication flow between UE, AMF, AUSF, and UDM
2. **PDU Session Establishment**: The process of establishing a session between UE, AMF, SMF, and UPF
3. **Registration Procedure**: The registration flow for a UE connecting to the network
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Acknowledgments
- 3GPP specifications for 5G architecture
- Open5GS project for reference implementation
- The Next.js and React communities for excellent tools and libraries