Fork a monkey 🐵 → Watch it evolve with AI 🤖 → Breed rare traits 🧬 → Free forever 💸
| ⚡ Takes 30 Seconds | 🤖 Evolves Daily | 💸 100% Free | 🌳 Join 20+ Monkeys |
|---|
Imagine Tamagotchi meets GitHub meets AI.
Your ForkMonkey is a digital pet that:
- 🏠 Lives in your GitHub repo (you truly own it)
- 🧬 Evolves every night while you sleep (AI decides the changes)
- 👶 Breeds through forking (create children with inherited traits)
- 🏆 Competes on a leaderboard (rarity rankings across all monkeys)
- 💰 Costs $0 forever (runs on GitHub's free tier)
"I bred a LEGENDARY golden monkey on day 23!" — Early Adopter
View the dashboard, leaderboard, family tree, and community gallery!
Click the big green button below 👇
Go to Actions tab → Click "I understand my workflows, go ahead and enable them"
Actions → "Initialize New Monkey" → "Run workflow" → Wait 30 seconds 🐵
Your monkey is born! Check the README or visit https://YOUR-USERNAME.github.io/forkMonkey/
| Generation | Age | Mutations | Rarity Score |
|---|---|---|---|
| 1 | 39 days | 7 | 31.7/100 |
Every night, GPT-4o (via GitHub Models) evolves your monkey. No API key needed!
Day 1: 🐵 Born with random DNA
Day 7: 🐵 Grew sunglasses (RARE!)
Day 30: 🐵 Changed to golden color
Day 100: 🐵 Completely unique creature
Fork any monkey to create a child that inherits traits:
- 50% from parent
- 50% random mutations
- Rare traits can be inherited!
| Tier | Chance | Examples |
|---|---|---|
| ⚪ Common | 60% | Basic colors |
| 💚 Uncommon | 25% | Accessories |
| 💙 Rare | 10% | Unique patterns |
| 🦄 Legendary | 5% | Ultra-rare combos |
Some legendary traits are only available in early generations — they become EXTINCT forever:
| Trait | Max Generation | Status |
|---|---|---|
| 🏆 Genesis Aura | Gen 1 only | 🔒 |
| 👑 Alpha Crown | Gen 1-3 | 🔒 |
| ✨ Founders Badge | Gen 1-5 | 🔒 |
| 🌟 Pioneer Glow | Gen 1-10 | 🔒 |
Fork early to get these ultra-rare traits before they're gone forever!
Keep your monkey evolving daily to build streaks and unlock rewards:
| Streak | Reward |
|---|---|
| 🏅 7 days | Week Warrior badge |
| ⚔️ 14 days | Fortnight Fighter |
| 💎 30 days | Diamond Hands |
| 💯 100 days | Century Legend |
Watch the network grow as monkeys breed across GitHub. Your lineage matters!
Unlock 12 achievements: First Hatch, Week Warrior, Diamond Hands, and more!
| Rank | Monkey | Rarity |
|---|---|---|
| 🥇 | richinseattle/forkMonkey | 40.0 |
| 🥈 | springsoftware-io/forkMonkey | 35.0 |
| 🥉 | loukasgr/forkMonkey | 31.7 |
| ... | Your monkey could be here! | ??? |
┌─────────────────────────────────────────────────────────────┐
│ 1. FORK → 2. EVOLVE → 3. BREED → 4. WIN │
│ │
│ 🍴 Fork 🤖 AI evolves 👶 Others fork 🏆 Climb │
│ the repo it every night your monkey leaderboard│
└─────────────────────────────────────────────────────────────┘
The secret sauce:
- GitHub Actions = The heartbeat (runs daily, free)
- GitHub Models = The brain (GPT-4o, free)
- GitHub Pages = The face (hosting, free)
- Git commits = The memory (history, free)
Total cost: $0/month forever 🎉
Click to expand developer docs
# Install dependencies
pip install -r requirements.txt
# Initialize your monkey
python src/cli.py init
# View in web interface
./start_web.sh
# Evolve monkey manually
python src/cli.py evolve --ai
# Show monkey stats
python src/cli.py show
# Generate shareable tweet
python src/cli.py share
# Run tests
pytest tests/forkMonkey/
├── .github/workflows/ # GitHub Actions (daily evolution, deploy)
├── src/ # Python backend (genetics, AI, CLI)
├── web/ # Frontend dashboard
├── monkey_data/ # Your monkey's DNA and history
└── promotion/ # Marketing materials
- Get API key from console.anthropic.com
- Add secret:
ANTHROPIC_API_KEY - Add variable:
AI_PROVIDER=claude
Your child inherits traits from this monkey + gets random mutations.
🧬 Notable Traits: Purple (rare), Space (rare)
🍴 Fork to inherit these rare genetics!
⚡ First 5 forks get +15% legendary trait inheritance!
Will you breed the next Legendary? 🦄
"Best GitHub project I've seen this year" — Developer
- ⭐ Star this repo to follow updates
- 🍴 Fork to adopt your own monkey
- 🐦 Share on Twitter with #ForkMonkey
- 💬 Open an issue with questions or ideas
MIT License — Fork, breed, and evolve freely!
