# TelecomFun
Educational telecom simulations for studying wireless concepts (NR / LTE).
---
## Requirements
Install **uv** (Python project and package manager):
```bash
curl -Ls https://astral.sh/uv/install.sh | sh
````
or
```bash
pip install uv
```
Python **3.11+** is required.
---
## Project Initialization
Clone the repository:
```bash
git clone https://gitverse.ru/TraurigerNarr/TelecomFun.git
cd TelecomFun
```
Create the virtual environment and install dependencies:
```bash
uv sync
```
---
## Run the Application
Run available stages:
```bash
uv run telecomfun
```
Show CLI help:
```bash
uv run telecomfun --help
```
---
## Development Setup
Install git hooks for linters:
```bash
uv run pre-commit install
```
Run linters manually:
```bash
uv run pre-commit run --all-files
```
---
## Project Structure
```
src/
grid/ # resource grid logic
nr/ # NR-specific components
render/ # visualization
```