An open API service indexing awesome lists of open source software.

https://github.com/omarelfiki/unity-ml-drl-data

Collecting data on agents training/acting in 3D simulations and analyzing it with ML
https://github.com/omarelfiki/unity-ml-drl-data

3d-models csharp machine-learning ml-agents python unity

Last synced: 4 months ago
JSON representation

Collecting data on agents training/acting in 3D simulations and analyzing it with ML

Awesome Lists containing this project

README

          

# unity-ml-drl-data
### Group 6 - P2-1: Artificial Intelligence & Machine Learning

unity-ml-drl-data is a GitHub repository for experienting with Deep Reinforcement Learning (DRL) using Unity and ML-Agents. This project uses simulated 3D enviroments to study and train agents with DRL algorithms, while logging performance and behavioral data for analysis using Machine Learning Techniques.

### Project Structure
```
unity-ml-drl-data/

├── unity/ # Unity project files (scenes, agents, environment scripts)
├── training/ # Python training scripts, configs, and utilities
├── data/ # Collected data and schema definitions
├── docs/ # Documentation, research notes, and reports
└── README.md # This file
```

### Installation
**1. Clone Repository**
```
git clone https://github.com/omarelfiki/unity-ml-drl-data.git
cd unity-ml-drl-data
```

**2. Install Unity**
* Download and Install Unity Hub
* Install recommended Unity Editor version: 6.2 (6000.2.2f1)
* Open the ```/unity``` folder as a Unity project.

**3. Set up Python enviroment (Python 3.10.12)**
From the root of the repository:
```
cd training
python setup_env.py
```

This will:
* Create a Python virtual environment in training/venv.
* Install all dependencies from the appropriate requirements file (based on your system).

> Ensure you have Python 3.10.12 available (via pyenv, conda, or system Python).

### Unity Dependencies

This project uses the official Unity ML-Agents package along with Barracuda for inference.

- **ML-Agents (C#)**: Installed from the Unity Package Manager (`com.unity.ml-agents`)
- **Barracuda**: Installed automatically as a dependency

> No manual action is required — Unity will add these packages when you open the project.

## Contributors
* @omarelfiki
* @AlexPayn
* @AshourKaria
* @Lorenzo-D-Coder2
* @ntlonggx
* Alexandru Mihăilă