Metadata-Version: 2.4
Name: catai-linux
Version: 0.7.5
Summary: Virtual desktop pet cats for Linux — pixel art cats that roam your screen and chat via AI
Author: Gheop
License-Expression: MIT
Project-URL: Homepage, https://github.com/Gheop/CATAI-Linux
Project-URL: Repository, https://github.com/Gheop/CATAI-Linux
Project-URL: Issues, https://github.com/Gheop/CATAI-Linux/issues
Keywords: desktop-pet,cat,pixel-art,linux,gtk4,claude,ollama,ai-chat,wayland
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: GTK
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyGObject
Requires-Dist: Pillow
Requires-Dist: httpx
Requires-Dist: anthropic
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: build; extra == "dev"
Provides-Extra: voice
Requires-Dist: faster-whisper>=1.0; extra == "voice"
Requires-Dist: piper-tts>=1.4; extra == "voice"
Requires-Dist: vosk>=0.3.45; extra == "voice"
Dynamic: license-file

# CATAI-Linux

[![PyPI](https://img.shields.io/pypi/v/catai-linux)](https://pypi.org/project/catai-linux/)
[![Python](https://img.shields.io/pypi/pyversions/catai-linux)](https://pypi.org/project/catai-linux/)
[![License](https://img.shields.io/github/license/Gheop/CATAI-Linux)](https://github.com/Gheop/CATAI-Linux/blob/main/LICENSE)
[![CI](https://github.com/Gheop/CATAI-Linux/actions/workflows/lint.yml/badge.svg)](https://github.com/Gheop/CATAI-Linux/actions)

Virtual desktop pet cats for Linux -- pixel art cats that roam your screen and chat with you via AI (Claude or Ollama).

![CATAI-Linux](https://raw.githubusercontent.com/Gheop/CATAI-Linux/main/screenshot2.png)

## Install

```bash
# System dependencies (GTK4 + Cairo, not available via pip)
# Fedora:
sudo dnf install python3-gobject
# Ubuntu/Debian:
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-4.0

pip install catai-linux

# Optional: adds ~100 MB of deps (faster-whisper) for voice chat
pip install catai-linux[voice]
```

## Run

```bash
catai
```

## Features

- Animated pixel-art cats roaming freely across your screen
- 6 cat personalities with AI chat (Claude API or Ollama)
- **Voice chat** 🎤 (optional) — hold Space or the mic button to talk to your cats. 100% local transcription via faster-whisper, GPU-accelerated if you have CUDA
- **Cat encounters**: when two cats cross paths, they stop and have a short AI-generated conversation
- **Love encounters & kittens**: occasional love → kitten births with fade-in + sparkles
- **22 easter eggs** with magic phrases (`nyan`, `matrix`, `thanos`, `don't panic`...)
- Click-through: cats float above windows, clicks pass through
- Drag & drop, random meows, settings UI
- Multilingual (FR/EN/ES), autostart at login
- Lazy loading + disk cache for instant startup

Full documentation on [GitHub](https://github.com/Gheop/CATAI-Linux).
