Your majestic digital lion that lives forever on GitHub and evolves with AI
ForkLion is an autonomous, self-evolving digital collectible that combines:
- 🎮 Tamagotchi-style digital pets
- 🎨 Genetic breeding mechanics
- 🦁 Majestic lion traits
- 🤖 AI-powered daily evolution
Each ForkLion is a unique digital creature that:
- Lives on GitHub as a repository
- Evolves daily through AI-powered mutations
- Changes appearance based on its DNA
- Breeds through forks - create new generations
- Grows a pride across the GitHub network
- Your Lion: The owner of the GitHub repo owns the lion
- Fork to Breed: Fork the repo to create a cub with inherited + mutated traits
- AI Evolution: Every day, an AI agent slightly modifies your lion's appearance
- Secret DNA: Lion traits are stored as GitHub Secrets (only you can see them)
- Public Art: The lion's visual representation updates daily in the README
- Network Effect: All lions form a pride across GitHub
Day 1: 🦁 Born with random DNA
Day 2: 🦁 AI mutates mane color
Day 3: 🦁 Grows a crown
Day 4: 🦁 Expression changes
...
Day 365: 🦁 Completely unique creature
Fork it: 🦁 Cub inherits 50% parent DNA + 50% random + daily mutations
- DNA Traits: Color, mane, accessories, expressions, patterns
- Inheritance: Cubs inherit traits from parents with mutations
- Rarity System: Some traits are rarer than others
- Generation Tracking: Know your lion's lineage
ForkLion uses GitHub Models (gpt-4o) by default for free AI-powered evolution!
- Daily Mutations: AI subtly evolves your lion
- Smart Changes: AI understands aesthetics and makes coherent changes
- Personality Development: Lions develop unique personalities over time
- SVG Generation: Procedurally generated lion art with majestic manes
- Real-time Updates: README shows current lion state
- History Tracking: See how your lion evolved over time
Click the "Fork" button to create your own lion repository.
Go to Actions tab and enable workflows.
- Go to Actions tab
- Select "Initialize New Lion" from the sidebar
- Click "Run workflow"
- Your lion is being born! 🦁
In Actions → Daily Evolution → Enable workflow
- Generation: 1
- Age: 56 days
- Mutations: 12
- Rarity Score: 28.3/100
Fork this repo to create cubs!
pip install -r requirements.txt
python src/cli.py init
python src/cli.py evolve --ai
python src/cli.py show- 🎮 Tamagotchi: Virtual pets that need care
- 🦁 Safari: Wild animal beauty
- 🌱 Seed-GPT: AI-powered autonomous growth
MIT License - Fork, breed, and evolve freely!
It's all free, public and uses free mechanism of Github.
Your lion is unique. Your lion is majestic. Your lion is forever on GitHub. 🦁✨