p3nGu1nZz commited on
Commit
8b012e9
1 Parent(s): 3be0191

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +52 -0
README.md CHANGED
@@ -1,3 +1,55 @@
1
  ---
2
  license: mit
 
 
 
 
 
 
 
 
3
  ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  license: mit
3
+ tags:
4
+ - unity
5
+ - ragdoll
6
+ - onnx
7
+ - machine learning
8
+ - active ragdoll
9
+ - vision
10
+ - lstm
11
  ---
12
+
13
+ # Kyle - Robot Walker Ragdoll Trainer
14
+
15
+ ## Model Description
16
+ Kyle is a state-of-the-art active ragdoll training environment in Unity, featuring a heavily modified and optimized codebase from the original Ragdoll Trainer. Our version includes advanced vision capabilities and short-term variable memory using LSTM (Long Short-Term Memory) networks, providing a more sophisticated simulation for AI training.
17
+
18
+ ## How to Use the Model
19
+ To ensure proper functionality of the Ragdoll Trainer within the Neko Cat Game, it is essential to utilize the **skeletal armature GameObject** provided with our modified project. This GameObject is specifically tailored for our Ragdoll Trainer and can be found as a child object within the main project directory at `https://github.com/cat-game-research/Neko/tree/main/RagdollTrainer`.
20
+
21
+ 1. Import the ONNX model into your Unity project.
22
+ 2. Attach the model to the skeletal armature GameObject included with our modified Ragdoll Trainer project.
23
+ 3. Utilize the model's capabilities to train and simulate realistic ragdoll movements with enhanced cognitive functions.
24
+
25
+ ## Training Data
26
+ The model was trained on a comprehensive dataset that includes various ragdoll movements, enriched with visual inputs and memory components to simulate real-world scenarios effectively.
27
+
28
+ ## Evaluation Results
29
+ Kyle has undergone extensive testing, showcasing remarkable proficiency in simulating lifelike ragdoll physics with the added depth of vision and memory-based learning.
30
+
31
+ ## Ethical Considerations
32
+ We adhere to ethical AI development practices, ensuring our models are created with fairness, accountability, and transparency at their core.
33
+
34
+ ## Acknowledgements
35
+ We extend our gratitude to the creators of the original Ragdoll Trainer project for their foundational work. Our enhancements were made possible by building upon their innovative approach to active ragdoll training.
36
+
37
+ ## Additional Information
38
+ - **Author**: p3nGu1nZz
39
+ - **Unity Version**: 2023.2.7f1
40
+ - **ONNX Version**: 1.12.0
41
+ - **ML-Agents Version**: 3.0.0-exp.1
42
+ - **ML-Agents Extensions Version**: 0.6.1-preview
43
+ - **Sentis Version**: 1.3.0-pre.2
44
+ - **Features**:
45
+ - Enhanced rig created in Blender for more natural movement.
46
+ - Heuristic function for joint control during development testing.
47
+ - Stabilizers for hips and spine to aid balance.
48
+ - Early training settings for initial balance and walking towards targets.
49
+ - Navigation around obstacles using Ray Perception Sensor 3D.
50
+ - Training for navigating steps and stairs with varying difficulty.
51
+ - **Setup Process**:
52
+ - Local Miniconda installation and configuration.
53
+ - Cloning of the latest tag of ML-Agents into the project.
54
+ - Script configuration for fine-tuning models based on Kyle.
55
+