metadata

title: DigiPal - AI Digital Pet
emoji: 🥚
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: AI-powered digital pet inspired by Digimon World 1
hf_oauth: true
hf_oauth_scopes:
  - read-repos
  - inference-api

🥚 DigiPal - Your AI Digital Pet

A sophisticated digital pet application inspired by Digimon World 1, featuring real-time AI interaction, dynamic evolution, and immersive pet care mechanics.

✨ Features

🤖 Advanced AI Integration

Natural Language Processing with Qwen3-0.6B for contextual conversations
Speech Recognition via Kyutai speech-to-text
Dynamic Image Generation using FLUX.1-dev for real-time pet visualization

🎮 Rich Pet Mechanics

7 Life Stages: Egg → Baby → Child → Adult → Champion → Ultimate → Elderly
Care System: Feed, train, and nurture your DigiPal with 20+ care actions
Evolution System: Your care quality determines evolution paths
Generational Inheritance: Perfect care = 25% stat inheritance to next generation

🏠 Persistent World

Real-time Updates: Pets age and evolve even when you're away
Backup System: Automatic save states and recovery
Authentication: Secure HuggingFace token integration

🚀 Quick Start

Online Mode (Recommended)

Enter your HuggingFace API token for full AI features
Select your starter egg from 4 unique types
Begin caring for your DigiPal through its life journey

Offline Mode

Check "Enable Offline Mode"
Enter any placeholder token
Experience core mechanics without AI features

🎯 Gameplay Loop

Hatch Your Egg: Choose from Flame, Ocean, Forest, or Sky eggs
Daily Care: Feed, train, play, and interact with your pet
Watch Evolution: Care quality determines evolution outcomes
Generational Play: When pets reach end-of-life, their DNA influences the next generation

📖 Care Guide

🍎 Feeding

Fruits: Increase happiness and health
Vegetables: Boost training effectiveness
Treats: Special happiness boost but use sparingly

🏋️ Training

Strength: Physical power and combat readiness
Intelligence: Learning speed and AI interaction quality
Endurance: Longevity and resistance to illness

💝 Care Quality

Your pet's care level affects everything:

Perfect Care (90-100%): Best evolution options, 25% inheritance
Excellent Care (80-89%): Great evolutions, 20% inheritance
Good Care (70-79%): Standard growth, 15% inheritance

🎨 Generated Content

DigiPal creates unique visual content for your pet using FLUX.1-dev, with intelligent caching for performance. Each pet's appearance reflects its species, life stage, and care history.

🔒 Privacy & Security

Secure token storage with encryption
Local data processing where possible
Optional offline mode for privacy-conscious users
Automatic backup system protects your progress

Ready to start your DigiPal journey? 🚀