Your loyal digital dog that lives forever on GitHub and evolves with AI
ForkDog is an autonomous, self-evolving digital collectible that combines:
- 🎮 Tamagotchi-style digital pets
- 🎨 Genetic breeding mechanics
- 🐶 Adorable dog traits
- 🤖 AI-powered daily evolution
Each ForkDog 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 pack across the GitHub network
- Your Dog: The owner of the GitHub repo owns the dog
- Fork to Breed: Fork the repo to create a puppy with inherited + mutated traits
- AI Evolution: Every day, an AI agent slightly modifies your dog's appearance
- Secret DNA: Dog traits are stored as GitHub Secrets (only you can see them)
- Public Art: The dog's visual representation updates daily in the README
- Network Effect: All dogs form a pack across GitHub
Day 1: 🐶 Born with random DNA
Day 2: 🐶 AI mutates fur color
Day 3: 🐶 Gets a collar
Day 4: 🐶 Expression changes
...
Day 365: 🐶 Completely unique creature
Fork it: 🐕 Puppy inherits 50% parent DNA + 50% random + daily mutations
- DNA Traits: Color, ears, accessories, expressions, patterns
- Inheritance: Puppies inherit traits from parents with mutations
- Rarity System: Some traits are rarer than others
- Generation Tracking: Know your dog's lineage
ForkDog uses GitHub Models (gpt-4o) by default for free AI-powered evolution!
- Daily Mutations: AI subtly evolves your dog
- Smart Changes: AI understands aesthetics and makes coherent changes
- Personality Development: Dogs develop unique personalities over time
- SVG Generation: Procedurally generated dog art with floppy ears
- Real-time Updates: README shows current dog state
- History Tracking: See how your dog evolved over time
Click the "Fork" button to create your own dog repository.
Go to Actions tab and enable workflows.
- Go to Actions tab
- Select "Initialize New Dog" from the sidebar
- Click "Run workflow"
- Your dog is being born! 🐶
In Actions → Daily Evolution → Enable workflow
- Generation: 1
- Age: 56 days
- Mutations: 12
- Rarity Score: 18.3/100
Fork this repo to create puppies!
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
- 🐶 Best Friend: Man's loyal companion
- 🌱 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 dog is unique. Your dog is loyal. Your dog is forever on GitHub. 🐶✨