catai-linux 0.1.0__tar.gz

catai_linux-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gheop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

catai_linux-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include PYPI_README.md
+include LICENSE
+recursive-include catai_linux/cute_orange_cat *.png *.json

catai_linux-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: catai-linux
+Version: 0.1.0
+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"
+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 (Fedora)
+sudo dnf install python3-gobject python3-pillow xdotool wmctrl
+
+# Install from PyPI
+pip install catai-linux
+```
+
+## Run
+
+```bash
+catai
+```
+
+## Features
+
+- Animated pixel-art cats roaming freely across your screen
+- 6 cat personalities with AI chat (Claude API or Ollama)
+- Always-on-top, drag & drop, random meows
+- Settings UI, multilingual (FR/EN/ES), autostart option
+
+Full documentation on [GitHub](https://github.com/Gheop/CATAI-Linux).

catai_linux-0.1.0/PYPI_README.md

@@ -0,0 +1,35 @@
+# 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 (Fedora)
+sudo dnf install python3-gobject python3-pillow xdotool wmctrl
+
+# Install from PyPI
+pip install catai-linux
+```
+
+## Run
+
+```bash
+catai
+```
+
+## Features
+
+- Animated pixel-art cats roaming freely across your screen
+- 6 cat personalities with AI chat (Claude API or Ollama)
+- Always-on-top, drag & drop, random meows
+- Settings UI, multilingual (FR/EN/ES), autostart option
+
+Full documentation on [GitHub](https://github.com/Gheop/CATAI-Linux).

catai_linux-0.1.0/README.md

@@ -0,0 +1,132 @@
+# CATAI-Linux
+
+Virtual desktop pet cats for Linux (GNOME/Wayland) -- pixel art cats that roam your screen and chat with you via AI.
+
+![Python](https://img.shields.io/badge/Python-GTK4-blue) ![Linux](https://img.shields.io/badge/Linux-Fedora%2FGNOME-orange) ![Claude](https://img.shields.io/badge/Claude-AI-blueviolet) ![Ollama](https://img.shields.io/badge/Ollama-LLM-green)
+
+Port of [CATAI](https://github.com/wil-pe/CATAI) (macOS/Swift) to Linux.
+
+![CATAI-Linux Screenshot](screenshot2.png)
+
+![CATAI-Linux Chat](screenshot1.png)
+
+## Features
+
+- **Desktop companion** -- Cats roam freely across your screen with pixel-perfect animations
+- **Always on top** -- Cats stay visible above all windows
+- **Multi-cat** -- Up to 6 cats with distinct colors and personalities
+- **AI chat** -- Click a cat to open a pixel-art chat bubble, powered by [Claude](https://claude.ai) or [Ollama](https://ollama.ai)
+- **Random meows** -- Cats spontaneously say "Miaou~", "Prrr...", "Mrrp!" in cute speech bubbles
+- **Drag & drop** -- Drag cats anywhere on your screen
+- **Multilingual** -- French, English, Spanish
+- **Persistent** -- Cats remember their conversations between sessions
+
+## Cat Personalities
+
+Each cat has a unique personality that shapes how it responds in conversations:
+
+| Color | Name | Personality | Specialty |
+|-------|------|-------------|-----------|
+| Orange | Citrouille | Playful & mischievous | Jokes & puns |
+| Black | Ombre | Mysterious & philosophical | Deep questions |
+| White | Neige | Elegant & poetic | Poetry & grace |
+| Grey | Einstein | Wise & scholarly | Science facts |
+| Brown | Indiana | Adventurous storyteller | Epic tales |
+| Cream | Caramel | Cuddly & comforting | Emotional support |
+
+## AI Backend
+
+CATAI-Linux supports two AI backends for cat conversations:
+
+| Backend | Setup | Speed | Cost |
+|---------|-------|-------|------|
+| **Claude** (recommended) | Auto-detected if [Claude Code](https://claude.ai/download) is installed | ~1-2s | Included with Claude subscription |
+| **Ollama** | `./setup-ollama.sh` | ~2-5s | Free (local) |
+
+Claude is auto-detected from Claude Code's credentials (`~/.claude/.credentials.json`) or the `ANTHROPIC_API_KEY` environment variable. If neither is available, CATAI falls back to Ollama.
+
+## Requirements
+
+- Linux with X11 or XWayland (GNOME, KDE, etc.)
+- Python 3.10+
+
+## Install
+
+```bash
+# System dependencies (Fedora)
+sudo dnf install python3-gobject python3-pillow xdotool wmctrl
+
+# Install from PyPI
+pip install catai-linux
+```
+
+## Run
+
+```bash
+catai
+```
+
+## Setup Ollama (optional)
+
+```bash
+./setup-ollama.sh
+```
+
+Pulls `gemma3:1b` (~815MB), a lightweight model. Other options:
+
+```bash
+ollama pull gemma3:4b     # Better quality, ~3GB
+ollama pull phi4-mini     # Microsoft, ~2.5GB
+ollama pull qwen3:1.7b    # Alibaba, ~1.3GB
+```
+
+## Settings
+
+Right-click any cat to access Settings:
+
+- **Language** -- French / English / Spanish
+- **Cats** -- Click a color to add, click x to remove
+- **Name** -- Rename each cat
+- **Size** -- Scale slider
+- **Model** -- Choose between Claude and Ollama models
+
+## How It Works
+
+- Single Python file, zero framework dependencies beyond GTK4
+- GTK4 + XWayland for transparent, always-on-top overlay windows
+- Pillow for sprite loading and per-pixel HSB color tinting
+- Claude API or Ollama for streaming AI chat
+- 368 hand-drawn sprites (8 directions x 5 animations)
+- Config persisted in `~/.config/catai/`
+
+## Development
+
+```bash
+make lint    # Run ruff linter
+make fix     # Auto-fix lint issues
+```
+
+CI runs ruff on every push/PR via GitHub Actions.
+
+## Project Structure
+
+```
+.
+├── catai_linux/          # Python package
+│   ├── app.py            # Main application
+│   ├── __main__.py       # Entry point (python -m catai_linux)
+│   └── cute_orange_cat/  # Sprite assets (68x68 PNG)
+├── pyproject.toml        # Package config + linter config
+├── Makefile              # make run / lint / fix / build
+├── setup-ollama.sh       # Ollama installer
+└── .github/workflows/    # CI: lint + PyPI publish
+```
+
+## Credits
+
+- Original macOS version: [wil-pe/CATAI](https://github.com/wil-pe/CATAI)
+- Sprite assets from the original project
+
+## License
+
+MIT

catai_linux-0.1.0/catai_linux/__init__.py

@@ -0,0 +1,3 @@
+"""CATAI-Linux — Virtual desktop pet cats for Linux."""
+
+__version__ = "0.1.0"

catai_linux-0.1.0/catai_linux/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m catai_linux"""
+
+from catai_linux.app import main
+
+main()