🌱 SEEDLING

Procedural Terminal Pet Engine (Rust • TUI • Fully Deterministic Lifeforms)

Every creature is born from a seed.
No two are the same. No servers. No APIs.
Just pure code → life.

---

🧬 What is this?

Seedling is a fully local, Rust-powered, terminal-based digital pet system inspired by Tamagotchi and procedural generation engines like No Man’s Sky.

Each creature is:

• Generated from a unique seed
• Deterministic (same seed = same creature forever)
• Fully stateful (it evolves, decays, remembers)

All rendered in a live animated terminal UI.

---

⚡ Features

• 🧠 Procedural DNA system

  • Species, traits, personality, rarity
  • Generated from a single seed

• 🎨 Animated ASCII Creature Renderer

  • Multiple body archetypes
  • Mood-based expressions
  • Idle + reactive animation

• 🧬 Rarity Engine

  • Common → Uncommon → Rare → Mythic → Singularity
  • Visual + behavioral differences

• 📊 Live Stat System

  • Hunger
  • Happiness
  • Energy
  • Passive decay over time

• 📜 Event Feed

  • Real-time local timestamps
  • Tracks interactions + lifecycle events

• 💾 Persistent Save System

  • Stored locally (/saves/pet.json)
  • Your creature survives restarts

---

---

🚀 Installation

git clone https://github.com/ShamelesAbyss/Vizr.git
cd seedling
cargo build --release

## RUN:

./target/release/seedling


## CREATE SPECIFIC CREATURES

./target/release/seedling new 777777

Same seed → same creature forever....

## 🎮 Controls

Key
Action
f
Feed
p
Play
s
Sleep
n
New random pet
q
Quit

## 🧠 How It Works

Seed → RNG → Trait selection
Traits influence:
Appearance
Mood
Animation behavior
Stats decay over time
UI updates every frame
State persists to disk

## 🧬 Rarity System

Tier
Meaning
Common
Basic creature
Uncommon
Slight variation
Rare
Unique traits
Mythic
Visual anomalies
Singularity
Reality questionable

## 🔮 Future Ideas

Evolution stages (baby → adult → ???)
Trait mutations over time
Breeding system (seed mixing)
Multiple creatures per habitat
Sound engine (beeps + personality tones)
Networked habitats (shared ecosystems)

## ⚙️ Tech Stack

Rust
Ratatui (TUI rendering)
Crossterm (terminal control)
Serde (state persistence)
Chrono (local time engine)

## 🧠 Philosophy

This is not just a pet.
It’s:
A deterministic lifeform
A local-first simulation
A tiny procedural universe
No cloud. No accounts. No tracking.
Just: seed → entropy → creature

## 🧪 Author

Built by
ShamelesAbyss

## 🧩 License

MIT — do whatever you want, just don’t make it boring.