# Koo Fruit Engine: Banana

[Procedural banana generation — parametric, animated, photo-matched.]

What you get is not a single banana. You get the parameter space — every banana, from any photo, in any state of peeling.

## Key Features

- [Photo-based workflow] — Load any banana photo. Auto-trace contour, then refine markers. Generate matched 3D model in seconds.
- [Multi-variety support] — Cavendish, blue java baby, red wild, plantain, ripe-spotted. Each preset reflects real botanical anatomy.
- [Animated peeling] — Configurable n-strip peel (default 3, up to 12) based on beam-bending physics. (constant curvature + multiplicative coupling). One slider drives keyframe animation.
- [Per-fiber binary cling] — Natural fiber tearing, not uniform stretching. Deterministic seed for reproducibility.
- [Realistic / Stylized toggle] — Photoreal shaders for product/film, stylized version for animation.
- [Cross-section anatomy] — Inner pulp, fiber bundles, suture lines all parametric.

## What you can build

- Kitchen / breakfast / market scenes — render-ready in seconds
- Character animation — peel-open sequences as props
- Stock asset libraries — deterministic seed = unlimited variations
- Educational / botanical — anatomical accuracy across varieties
- Procedural exploration — slider drag for live deformation

## How it works

1. Click [Generate] for a default banana, or load a reference photo
2. [Auto-trace Contour] detects the outline; place anatomical markers (stem, neck, stigma, thick-point)
3. [Generate Realistic Banana] matches the photo's curvature, length, color
4. Adjust [Length / Radius / Curvature] to refine
5. [Peel Open] + Amount / Curl / Fiber cling sliders for peel animation
6. [Animation panel] for keyframe export

## Tech specs

- Blender 4.2 LTS / 5.0+ compatible
- No user-side pip install — Pillow + onnxruntime wheels bundled for all platforms (Windows, macOS, Linux).
- Memory-disciplined: 5+ Generate cycles produce zero orphan datablocks
- Performance: ~4 seconds Generate on Low quality
- Output: editable mesh, vertex color shaders, optional shape keys

## License

GPL v3 (full source included). Use commercially, redistribute, modify under GPL terms.

## Roadmap

- Apple — multi-fruit Phase 2 trigger
- Flesh snap (brittle fracture model) and ripening animation
- Recipe Editor GUI, banana bunch / hand structure
- Full plant lifecycle (tree, flower, mature bunch)

---

[Koo Fruit Engine] is the first product in a series mapping the parameter space of natural forms. The principle: 9 (Koo) is the number of all forms — every banana, every apple, every plant has math, and each becomes a generator.

Built with Blender 5.x and a Python procedural pipeline.