Home
Name Modified Size InfoDownloads / Week
README.md 2026-05-31 2.0 kB
0
rw.73694.PawPal_0.1.0_aarch64.dmg 2026-05-31 16.1 MB
0
Totals: 2 Items   16.1 MB 0

PawPal 🐕

A desktop companion pet app built with Tauri. Keep a digital dog on your desktop that reacts to your cursor and can chat with you using your preferred LLM.

Features

  • Desktop Pet - An adorable dog that lives on your desktop
  • Cursor Interaction - Pet reacts to your mouse movements
  • LLM Chat - Chat with your pet using OpenAI, Anthropic, NVIDIA NIM, OpenRouter, or any compatible API
  • Floating Window - Always-on-top, transparent window that doesn't interfere with your workflow
  • Settings Panel - Configure API endpoints, models, and system prompts
  • Passthrough Mode - Toggle whether the pet blocks mouse clicks
  • Persistent Storage - Saves notes and settings locally

System Requirements

  • macOS (currently built for macOS)
  • Rust 1.70+ (for development)
  • Node.js 18+ (for development)

Installation

Download the latest .dmg file from Releases and drag PawPal to Applications.

First launch on macOS will prompt for accessibility permissions (required for mouse tracking).

Configuration

  1. Open Settings (right-click tray icon → Settings)
  2. Configure your LLM:
  3. API URL - Endpoint of your LLM provider
  4. API Key - Your authentication key
  5. Model - Model name to use
  6. System Prompt - Custom personality for your pet

Development

Tech Stack

  • Frontend - TypeScript, HTML, CSS
  • Backend - Rust with Tauri 2
  • Build - Vite

Setup

# Install dependencies
npm install
cargo build

# Start dev server
npm run tauri dev

# Build release
npm run tauri build

License

MIT License - see LICENSE file for details

Contributing

Contributions welcome! Feel free to open issues or PRs.

Recommended IDE Setup

Source: README.md, updated 2026-05-31