Sentient-Eye-Engine

A procedural, physics-based robot eye animation engine & surgical editor written in Python. Inspired by Murder Drones.

👁️ Sentient Eye Engine (Bio-Kernel v1.0)

"We don't just render pixels; we forge digital souls."

Sentient Eye Engine is a procedural, physics-based animation system designed to bring robotic characters to life. Unlike traditional sprite-based systems, this engine generates expressions in real-time using mathematical splines, soft-body physics, and a dynamic muscle system.

Inspired by the disassembly drones from Murder Drones.

![Editor Screenshot]

🚀 Features

🧬 Bio-Kernel Architecture

• Procedural Animation: No static images. Every blink, twitch, and glance is calculated in real-time.
• 5-Point Segment Rigging: Brows are simulated as muscle tissues, allowing for infinite expression possibilities.
• Physics-Based Rendering: Eyes react to "weight" added by digital scars or glitches.

🔧 Sentient Editor (Surgical Mode)

• Live Surgery: Cut, slice, and redraw the eye interface in real-time using the 'Cut Mode'.
• Clay Sculpting: Grab and pull brow segments like digital clay to create unique expressions.
• Parenting System: All drawn artifacts (scars, glitch lines) are parented to the pupil and move with the gaze.

📦 Installation

1. Clone the repository:

   git clone [https://github.com/SentientLabs/Sentient-Eye-Engine.git](https://github.com/SentientLabs/Sentient-Eye-Engine.git)

2. Install dependencies:

   pip install pygame

3. Run the Editor:

   python editor.py

🎮 Controls

• SPACE: Draw Mode (Add details)
• C: Cut Mode (Surgery/Masking)
• TAB: Open File Manager
• Right Click: Sculpt/Edit Nodes
• Scroll: Adjust Thickness / Brush Size
• T: Toggle Eye Visibility (For manual override)

🏗️ Architecture

Developed by Efe (Sentient Labs) under E.R.D. Interactive.

• face_renderer.py: The core engine handling the math and drawing.
• editor.py: The GUI tool for creating .json emotion files.
• assets/: Storage for emotion data.

---

Powered by Python & Pygame.