How cooklaye/studypet_portable works
StudyPet is a Tkinter emotional-support companion: students launch into a pet-centered study space, build a bond through study and care, and can use stress check-ins and relaxation tools. The app also includes local AI chat, music, task planning, drowsiness monitoring, and recovery of saved progress. The graph follows documented imports and README-described behavior; some subsystem internals are represented by their exact directories because their implementation files were not excerpted.
Main entry points: main_game_screen.py Main game · StudyPet.py App entry · app_state.py App state · stress_diagnosis.py Stress scoring
Components 34
App and screens
- App entry
src/StudyPet.py - Onboarding
src/screens/greeting_screen.py - Pet selection
src/screens/pet_selection_screen.py - Hatching
src/screens/hatch_screen.py - Main game
src/screens/main_game_screen.py
Pet and persistence
- Pet evolution
src/models/pet.py - App state
src/models/app_state.py - User profile
src/models/user.py - Pet state events
src/models/state_manager.py - Session recovery
src/utils/session_manager.py - File utilities
src/utils/file_utils.py
Well-being
- Stress access gate
src/screens/stress_gate_screen.py - Stress check-in panels
src/screens/stress_panels.py - Facial stress scan
stress_scan/live_scan.py - Stress scoring
src/utils/stress_diagnosis.py - Rant analysis
src/utils/stress_keywords.py - Stress mailbox
src/screens/stress_mailbox.py - Diagnosis flow
src/screens/diagnosis_flow.py - Breathing exercise
src/screens/breathing_exercise.py - Drowsiness monitor
src/utils/drowsiness_detector.py
Study tools
- AI companion chat
src/utils/chatbot_utils.py - Local AI manager
src/utils/model_manager.py - Local AI server
- Task planner
src/ui/tasks_panel.py - Study scheduler
src/screens/scheduler_screen.py - Music player
src/utils/music_player.py - Music analysis
src/utils/music_analysis.py
Interface components
- Pet renderer
src/graphics/pet_graphics.py - Playground renderer
src/graphics/simple_playground.py - Settings window
src/ui/unified_settings.py - Theme
src/ui/simple_theme.py - Pet theme
src/ui/pet_theme.py - Rounded widgets
src/ui/rounded_widgets.py
Other components
- Student
Connections 46
- Student → App entry: launches
README.md - App entry → Onboarding: opens
src/StudyPet.py - App entry → Pet selection: opens
src/StudyPet.py - App entry → Hatching: opens
src/StudyPet.py - App entry → Main game: opens
src/StudyPet.py - App entry → App state: loads
src/StudyPet.py - App entry → Session recovery: uses
src/StudyPet.py - App entry → Stress access gate: opens
src/StudyPet.py - Pet selection → Pet evolution: selects
src/screens/pet_selection_screen.py - Pet selection → Pet renderer: renders
src/screens/pet_selection_screen.py - Hatching → Pet renderer: renders
src/screens/hatch_screen.py - Main game → Pet evolution: reads
src/screens/main_game_screen.py - Main game → Playground renderer: renders
src/screens/main_game_screen.py - Main game → Pet renderer: renders
src/screens/main_game_screen.py - Pet evolution → Pet state events: notifies
src/models/app_state.py - App state → Pet evolution: manages
src/models/app_state.py - App state → User profile: manages
src/models/app_state.py - App state → File utilities: uses
src/models/app_state.py - App state → Session recovery: saves progress
README.md - Main game → AI companion chat: sends messages
src/screens/main_game_screen.py - Main game → Local AI manager: manages AI
src/screens/main_game_screen.py - Local AI manager → Local AI server: communicates
README.md - Main game → Stress mailbox: opens
src/screens/main_game_screen.py - Main game → Diagnosis flow: opens
src/screens/main_game_screen.py - Main game → Breathing exercise: opens
src/screens/main_game_screen.py - Stress access gate → Stress check-in panels: shows
src/screens/stress_gate_screen.py - Stress access gate → Stress scoring: uses
src/screens/stress_gate_screen.py - Stress check-in panels → Facial stress scan: starts scan
src/screens/stress_panels.py - Stress check-in panels → Stress scoring: scores quiz
src/screens/stress_panels.py - Diagnosis flow → Stress scoring: uses
src/screens/diagnosis_flow.py - Diagnosis flow → Stress check-in panels: shows
src/screens/diagnosis_flow.py - Diagnosis flow → Breathing exercise: offers
src/screens/diagnosis_flow.py - Stress mailbox → Stress scoring: submits text
src/screens/stress_mailbox.py - Stress scoring → Rant analysis: analyzes rant
src/utils/stress_diagnosis.py - Main game → Drowsiness monitor: monitors
README.md - Main game → Task planner: shows tasks
src/screens/main_game_screen.py - Task planner → App state: saves tasks
src/ui/tasks_panel.py - Main game → Study scheduler: opens
README.md - Main game → Music player: controls
src/StudyPet.py - Music player → Music analysis: uses
src/utils/music_player.py - Main game → Settings window: opens
src/screens/main_game_screen.py - Main game → Theme: uses
src/screens/main_game_screen.py - Main game → Pet theme: uses
src/screens/main_game_screen.py - Main game → Rounded widgets: uses
src/screens/main_game_screen.py - Settings window → Theme: uses
src/ui/unified_settings.py - Task planner → Rounded widgets: uses
src/ui/tasks_panel.py