Skip to content

Your intelligent pet journal powered by Ruixen. Track, analyze, and understand your furry friend's well-being.

Notifications You must be signed in to change notification settings

gitcoder89431/petalytics

Repository files navigation

🐾 Petalytics

Your intelligent pet journal powered by AI. Track, analyze, and understand your furry friend's well-being.

Live Demo CI

πŸŽ₯ Demo

Petalytics demo

β–² Deploy to Vercel

Deploy with Vercel

Notes:

  • No server secrets needed; set your OpenRouter API key inside the app (Guardian panel).
  • Default free model is enforced: openai/gpt-oss-120b:free.

✨ Features

  • πŸ€– AI-Powered Insights - Get personalized care recommendations using OpenRouter API
  • Ruixen agent orchestrator with built-in rate limiting and offline heuristics
  • πŸ“ Smart Journaling - Record daily activities, mood, and behavior patterns
  • 🎨 Beautiful Themes - 4 gorgeous themes (Everforest, Gruvbox Dark, Tokyo Night, Nord)
  • πŸ“Š Health Tracking - Monitor wellness trends over time
  • πŸ”’ Privacy First - Your data stays local, export/import JSONL files
  • πŸ“± Responsive Design - Works on desktop, tablet, and mobile

πŸš€ Quick Start

1. Get an OpenRouter API Key

  • Visit OpenRouter.ai
  • Sign up and get your API key
  • Copy the key (starts with sk-or-)

2. Use the App

  • Visit Petalytics
  • Enter your API key in Guardian Settings
  • Create your first pet profile
  • Start journaling!

3. Local Development

git clone https://github.com/gitcoder89431/petalytics.git
cd petalytics
npm install
npm run dev

Key Innovations

  • BYOK Model - No backend costs, users own their data
  • Shell App Architecture - Fully client-side with export/import
  • Breed-Specific AI - Tailored insights based on pet characteristics
  • Beautiful 3-Panel Layout - Inspired by modern desktop environments

Tech Highlights

  • SvelteKit + TypeScript for performance
  • Direct browser β†’ OpenRouter API integration
  • Theme system extracted from omarchy-theme-builder
  • JSONL data portability
  • Zero database dependencies

πŸ“Š Usage

1. Guardian Setup (Top-Left Panel)

  • Configure your profile and API key
  • Choose from 4 beautiful themes
  • Set preferences and reminders

2. Pet Management (Bottom-Left Panel)

  • Create pet profiles with photos
  • Add breed, age, and basic info
  • Select active pet for journaling

3. Main Dashboard (Right Panel)

  • View pet stats and recent activity
  • Write new journal entries
  • See AI analysis and recommendations
  • Browse journal history

πŸ€– AI Features

The AI analyzes journal entries considering:

  • Breed-specific traits (Golden Retriever vs Persian Cat)
  • Age-appropriate behavior (puppy vs senior dog)
  • Historical patterns (mood trends over time)
  • Health indicators (activity level changes)

Sample AI insights:

  • "Max seems more lethargic than usual for a young Golden Retriever"
  • "Consider increasing mental stimulation based on recent boredom signs"
  • "Schedule vet checkup - senior cats should be monitored closely"

πŸ” Privacy & Data

  • Local First - All data stored in browser localStorage
  • No Backend - Direct API calls to OpenRouter
  • Export/Import - Download JSONL backups anytime
  • BYOK - Bring your own API key, control your costs

🎨 Themes

Four beautiful themes extracted from omarchy-theme-builder:

  • Everforest - Comfortable green forest theme
  • Gruvbox Dark - Warm, retro-inspired colors
  • Tokyo Night - Modern dark with purple accents
  • Nord - Cool arctic-inspired palette

πŸ“± Responsive Design

  • Desktop - Full 3-panel layout with optimal workflow
  • Tablet - Adaptive layout with collapsible panels
  • Mobile - Stacked panels for touch-friendly navigation

πŸ› οΈ Development

Tech Stack

  • Frontend: SvelteKit + TypeScript
  • Styling: Tailwind CSS + Custom themes
  • AI: OpenRouter API (Claude, GPT models)
  • Deployment: Vercel
  • Data: localStorage + JSONL export/import

Scripts

npm run dev          # Development server
npm run build        # Production build
npm run test         # Run tests
npm run lint         # Code linting
npm run check        # Type checking

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Guardian Panel  β”‚                 β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€   Main Viewport β”‚
β”‚ Pet Panel       β”‚   (Dashboard,   β”‚
β”‚                 β”‚   Journal,      β”‚
β”‚                 β”‚   History)      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ† Contest Highlights

  1. Innovation: BYOK model eliminates backend complexity
  2. Design: Beautiful theme system with smooth transitions
  3. Performance: Lightning-fast SvelteKit implementation
  4. Privacy: User owns their data completely
  5. AI Integration: Smart breed-specific insights
  6. Accessibility: Full keyboard navigation support
  7. Mobile Ready: Responsive across all devices

πŸ“„ License

MIT License - see LICENSE for details.

πŸ™ Acknowledgments

  • OpenRouter for providing accessible AI APIs
  • Omarchy theme system for beautiful color palettes
  • SvelteKit team for an amazing framework
  • Contest organizers for the opportunity

Made with ❀️ for pets and their humans.

About

Your intelligent pet journal powered by Ruixen. Track, analyze, and understand your furry friend's well-being.

Topics

Resources

Contributing

Stars

Watchers

Forks