boba-pet 1.0.0__tar.gz

boba_pet-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdul Rahman Azam and Boba Pet contributors
+
+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.

boba_pet-1.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: boba-pet
+Version: 1.0.0
+Summary: Boba: an always-on-top desktop pet for Claude Code, Codex, Gemini and Groq on Windows.
+Author: Abdul Rahman Azam
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AbdulRahmanAzam/boba-pet
+Project-URL: Issues, https://github.com/AbdulRahmanAzam/boba-pet/issues
+Keywords: claude,claude-code,desktop-pet,ai-assistant,tkinter,windows
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.26
+Requires-Dist: sounddevice>=0.4
+Requires-Dist: vosk>=0.3.45
+Requires-Dist: faster-whisper>=1.0
+Requires-Dist: model2vec>=0.3
+Requires-Dist: tkinterdnd2>=0.4
+Dynamic: license-file
+
+# Boba Pet
+
+An always-on-top pixel-art desktop pet for Windows that talks to **Claude Code**
+(and Codex, Antigravity, Gemini or Groq). Click it, type or say "Hey Boba", and
+the answer pops up in a speech bubble. It watches your Claude Code sessions,
+reacts when they finish or fail, and keeps you on track with tasks, focus
+timers and a hackathon mode.
+
+## Install (one line)
+
+Open **PowerShell** and run:
+
+```powershell
+irm https://raw.githubusercontent.com/AbdulRahmanAzam/boba-pet/main/install.ps1 | iex
+```
+
+That's it. The installer:
+
+1. installs [uv](https://docs.astral.sh/uv/) if you don't have it,
+2. installs Boba Pet with its own private Python 3.12 (your Python is untouched),
+3. downloads the offline voice and search models (about 200 MB, one time),
+4. adds **Boba Pet** to the Start menu and starts the pet.
+
+No admin rights, no git clone. To also start the pet with Windows, run
+`$env:BOBA_PET_AUTOSTART="1"` before the line above, or later run
+`boba-pet-setup --autostart`.
+
+### Already have Python 3.11+?
+
+```powershell
+pip install boba-pet
+boba-pet
+```
+
+or, with [uv](https://docs.astral.sh/uv/), just `uvx boba-pet`. The first
+start downloads the voice models in the background; run `boba-pet-setup`
+once to get them right away and add a Start menu shortcut.
+### Update / uninstall
+
+```powershell
+uv tool upgrade boba-pet                       # update (or re-run the install line)
+boba-pet-setup --uninstall-shortcuts; uv tool uninstall boba-pet   # remove
+```
+
+Your settings and models stay in `%USERPROFILE%\.boba-pet` and
+`%USERPROFILE%\.claude-pet*.json`; delete them to remove everything.
+
+## Requirements
+
+- Windows 10 or 11
+- One AI to talk through (the pet has no key of its own; pick it from the
+  right-click menu > **AI provider**):
+  - [Claude Code](https://docs.claude.com/claude-code) (recommended):
+    `irm https://claude.ai/install.ps1 | iex`, then sign in once with `claude`
+  - Codex CLI (ChatGPT plan), Antigravity CLI (Google account), or a free
+    Groq / Gemini API key
+
+## What it does
+
+- **Chat** in a speech bubble; the chat keeps context, shows tokens used
+  (↑ input, ↓ output) and has a cheap **Compact** button that rolls the chat
+  into a short note.
+- **Quick menu**: click the ✱ in the ask box for ask, talk, screenshot, new
+  chat, compact, history, effort level and more.
+- **Voice, fully offline**: talk with the mic button (Whisper), say
+  "Hey Boba" to wake it (Vosk), and have replies read aloud (Windows TTS).
+- **Claude Code companion**: it looks busy while a session works, celebrates
+  when it finishes, sweats when tests fail and waves when Claude needs your
+  permission. A usage meter shows your plan limits and today's tokens.
+- **Projects**: "open my portfolio project" finds the folder and opens it in
+  VS Code with Claude Code running.
+- **Tasks, reminders and focus timer**, with a gentle distraction guard.
+- **Hackathons**: track deadlines, and click one for a workspace with a
+  checklist, notes, focus sprints, idea/pitch/judge helpers and a prompt coach
+  that suggests better Claude Code prompts while you build.
+- **Morning tech briefing** from real news feeds, every item linked to its source.
+- **Screenshots**: snip part of the screen and ask about it.
+- **Computer tools** (optional): the AI can open apps, change volume, type and
+  so on. By default it **asks you first** for anything risky; set the mode in
+  the menu, or turn it off.
+- **Characters**: several pixel-art pets; add your own with one file (see below).
+
+## Privacy
+
+- API keys you paste are saved only in `%USERPROFILE%\.boba-pet\.env` on your PC.
+- Speech recognition and the wake word run locally; audio never leaves the PC.
+- The pet reads Claude Code transcripts locally to react to sessions; their
+  text is not sent anywhere.
+- Requests to the AI go through the provider you linked, on your own account.
+
+## Run from source (for contributors)
+
+```powershell
+git clone https://github.com/AbdulRahmanAzam/boba-pet
+cd boba-pet
+uv venv --python 3.12 .venv
+uv pip install --python .venv\Scripts\python.exe -r requirements.txt
+.venv\Scripts\python.exe launch.py --setup   # optional: models + Start menu shortcut
+.venv\Scripts\pythonw.exe claude_pet.py
+```
+
+In a clone, the pet keeps `.env`, `models/` and `shots/` next to the code
+(all git-ignored). Copy `.env.example` to `.env` if you use Groq or Gemini keys.
+Set `BOBA_PET_PROJECTS` (folders separated by `;`) to choose where it looks
+for your projects.
+
+### Layout
+
+| File | What it is |
+|------|------------|
+| `claude_pet.py` | The pet window, menus, chat and everything that ties the parts together |
+| `providers.py`, `account.py` | Talking to Claude Code, Codex, Antigravity, Groq and Gemini |
+| `chatlog.py` | Chat history, token counts and compaction |
+| `sprites.py`, `sprite_*.py` | Pixel-art characters |
+| `listener.py`, `wake.py`, `speak.ps1` | Mic input (Whisper), wake word (Vosk), text to speech |
+| `cc_watch.py`, `pet_hook.py`, `pet_status.py`, `usage.py` | Claude Code session watching and usage meter |
+| `projects.py`, `vscode-ext/` | Project search and the VS Code launcher extension |
+| `tasks.py`, `focus.py` | Tasks, reminders, focus timer visuals |
+| `hackathons.py`, `hackmode.py` | Hackathon tracker and hackathon mode |
+| `news.py` | Morning briefing from RSS/Atom feeds |
+| `computer.py`, `pet_mcp.py` | Computer tools and their MCP server |
+| `snip.py`, `ui_fx.py` | Screen snipping, fades, markdown and other UI helpers |
+| `launch.py`, `pet_setup.py`, `pet_paths.py` | Installed command, first-run setup, data folders |
+
+### Add a character
+
+Drop a `sprite_<name>.py` file next to `sprites.py` with a
+`compose_<name>(...)` function (copy `sprite_bluebot.py` to start), an
+optional `NAME` for the menu and an optional `EXTRA_PALETTE`. It shows up in
+the menu on the next start.
+
+## Contributing
+
+Pull requests are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

boba_pet-1.0.0/README.md

@@ -0,0 +1,138 @@
+# Boba Pet
+
+An always-on-top pixel-art desktop pet for Windows that talks to **Claude Code**
+(and Codex, Antigravity, Gemini or Groq). Click it, type or say "Hey Boba", and
+the answer pops up in a speech bubble. It watches your Claude Code sessions,
+reacts when they finish or fail, and keeps you on track with tasks, focus
+timers and a hackathon mode.
+
+## Install (one line)
+
+Open **PowerShell** and run:
+
+```powershell
+irm https://raw.githubusercontent.com/AbdulRahmanAzam/boba-pet/main/install.ps1 | iex
+```
+
+That's it. The installer:
+
+1. installs [uv](https://docs.astral.sh/uv/) if you don't have it,
+2. installs Boba Pet with its own private Python 3.12 (your Python is untouched),
+3. downloads the offline voice and search models (about 200 MB, one time),
+4. adds **Boba Pet** to the Start menu and starts the pet.
+
+No admin rights, no git clone. To also start the pet with Windows, run
+`$env:BOBA_PET_AUTOSTART="1"` before the line above, or later run
+`boba-pet-setup --autostart`.
+
+### Already have Python 3.11+?
+
+```powershell
+pip install boba-pet
+boba-pet
+```
+
+or, with [uv](https://docs.astral.sh/uv/), just `uvx boba-pet`. The first
+start downloads the voice models in the background; run `boba-pet-setup`
+once to get them right away and add a Start menu shortcut.
+### Update / uninstall
+
+```powershell
+uv tool upgrade boba-pet                       # update (or re-run the install line)
+boba-pet-setup --uninstall-shortcuts; uv tool uninstall boba-pet   # remove
+```
+
+Your settings and models stay in `%USERPROFILE%\.boba-pet` and
+`%USERPROFILE%\.claude-pet*.json`; delete them to remove everything.
+
+## Requirements
+
+- Windows 10 or 11
+- One AI to talk through (the pet has no key of its own; pick it from the
+  right-click menu > **AI provider**):
+  - [Claude Code](https://docs.claude.com/claude-code) (recommended):
+    `irm https://claude.ai/install.ps1 | iex`, then sign in once with `claude`
+  - Codex CLI (ChatGPT plan), Antigravity CLI (Google account), or a free
+    Groq / Gemini API key
+
+## What it does
+
+- **Chat** in a speech bubble; the chat keeps context, shows tokens used
+  (↑ input, ↓ output) and has a cheap **Compact** button that rolls the chat
+  into a short note.
+- **Quick menu**: click the ✱ in the ask box for ask, talk, screenshot, new
+  chat, compact, history, effort level and more.
+- **Voice, fully offline**: talk with the mic button (Whisper), say
+  "Hey Boba" to wake it (Vosk), and have replies read aloud (Windows TTS).
+- **Claude Code companion**: it looks busy while a session works, celebrates
+  when it finishes, sweats when tests fail and waves when Claude needs your
+  permission. A usage meter shows your plan limits and today's tokens.
+- **Projects**: "open my portfolio project" finds the folder and opens it in
+  VS Code with Claude Code running.
+- **Tasks, reminders and focus timer**, with a gentle distraction guard.
+- **Hackathons**: track deadlines, and click one for a workspace with a
+  checklist, notes, focus sprints, idea/pitch/judge helpers and a prompt coach
+  that suggests better Claude Code prompts while you build.
+- **Morning tech briefing** from real news feeds, every item linked to its source.
+- **Screenshots**: snip part of the screen and ask about it.
+- **Computer tools** (optional): the AI can open apps, change volume, type and
+  so on. By default it **asks you first** for anything risky; set the mode in
+  the menu, or turn it off.
+- **Characters**: several pixel-art pets; add your own with one file (see below).
+
+## Privacy
+
+- API keys you paste are saved only in `%USERPROFILE%\.boba-pet\.env` on your PC.
+- Speech recognition and the wake word run locally; audio never leaves the PC.
+- The pet reads Claude Code transcripts locally to react to sessions; their
+  text is not sent anywhere.
+- Requests to the AI go through the provider you linked, on your own account.
+
+## Run from source (for contributors)
+
+```powershell
+git clone https://github.com/AbdulRahmanAzam/boba-pet
+cd boba-pet
+uv venv --python 3.12 .venv
+uv pip install --python .venv\Scripts\python.exe -r requirements.txt
+.venv\Scripts\python.exe launch.py --setup   # optional: models + Start menu shortcut
+.venv\Scripts\pythonw.exe claude_pet.py
+```
+
+In a clone, the pet keeps `.env`, `models/` and `shots/` next to the code
+(all git-ignored). Copy `.env.example` to `.env` if you use Groq or Gemini keys.
+Set `BOBA_PET_PROJECTS` (folders separated by `;`) to choose where it looks
+for your projects.
+
+### Layout
+
+| File | What it is |
+|------|------------|
+| `claude_pet.py` | The pet window, menus, chat and everything that ties the parts together |
+| `providers.py`, `account.py` | Talking to Claude Code, Codex, Antigravity, Groq and Gemini |
+| `chatlog.py` | Chat history, token counts and compaction |
+| `sprites.py`, `sprite_*.py` | Pixel-art characters |
+| `listener.py`, `wake.py`, `speak.ps1` | Mic input (Whisper), wake word (Vosk), text to speech |
+| `cc_watch.py`, `pet_hook.py`, `pet_status.py`, `usage.py` | Claude Code session watching and usage meter |
+| `projects.py`, `vscode-ext/` | Project search and the VS Code launcher extension |
+| `tasks.py`, `focus.py` | Tasks, reminders, focus timer visuals |
+| `hackathons.py`, `hackmode.py` | Hackathon tracker and hackathon mode |
+| `news.py` | Morning briefing from RSS/Atom feeds |
+| `computer.py`, `pet_mcp.py` | Computer tools and their MCP server |
+| `snip.py`, `ui_fx.py` | Screen snipping, fades, markdown and other UI helpers |
+| `launch.py`, `pet_setup.py`, `pet_paths.py` | Installed command, first-run setup, data folders |
+
+### Add a character
+
+Drop a `sprite_<name>.py` file next to `sprites.py` with a
+`compose_<name>(...)` function (copy `sprite_bluebot.py` to start), an
+optional `NAME` for the menu and an optional `EXTRA_PALETTE`. It shows up in
+the menu on the next start.
+
+## Contributing
+
+Pull requests are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

boba_pet-1.0.0/__init__.py

@@ -0,0 +1,3 @@
+"""Boba Pet: a desktop pet for Claude Code (and Codex, Gemini, Groq)."""
+
+__version__ = "1.0.0"

boba_pet-1.0.0/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from boba_pet.launch import main
+
+sys.exit(main())

boba_pet-1.0.0/account.py

@@ -0,0 +1,97 @@
+"""Linking the pet to the user's own Claude Code login.
+
+The pet never stores an API key or token. Every request goes through the
+`claude` CLI, so it runs on (and bills) whatever account Claude Code is
+signed in to on this computer. This module only checks that link and
+opens a terminal for installing Claude Code or signing in.
+"""
+
+import json
+import shutil
+import subprocess
+from pathlib import Path
+
+CREATE_NO_WINDOW = 0x08000000
+CREATE_NEW_CONSOLE = 0x00000010
+INSTALL_COMMAND = "irm https://claude.ai/install.ps1 | iex"
+# Phrases in a failed reply that mean the login is missing or expired.
+AUTH_ERRORS = ("not logged in", "please run /login", "invalid api key",
+               "authentication_error", "oauth token has expired", "/login")
+
+
+def find_claude() -> str | None:
+    """Path of the Claude Code CLI, or None when it is not installed."""
+    found = shutil.which("claude")
+    if found:
+        return found
+    local = Path.home() / ".local" / "bin" / "claude.exe"
+    return str(local) if local.exists() else None
+
+
+def status() -> dict:
+    """Check whether Claude Code is installed and signed in.
+
+    Returns:
+        {"installed": bool, "linked": bool, "email": str, "plan": str,
+         "method": str, "claude": path or None}
+    """
+    claude = find_claude()
+    info = {"installed": bool(claude), "linked": False, "email": "",
+            "plan": "", "method": "", "claude": claude}
+    if not claude:
+        return info
+    try:
+        out = subprocess.run([claude, "auth", "status"], capture_output=True,
+                             text=True, timeout=30, creationflags=CREATE_NO_WINDOW)
+        data = json.loads(out.stdout or "{}")
+    except (OSError, ValueError, subprocess.TimeoutExpired):
+        return info
+    info.update(linked=bool(data.get("loggedIn")), email=data.get("email") or "",
+                plan=data.get("subscriptionType") or "",
+                method=data.get("authMethod") or "")
+    return info
+
+
+def describe(info: dict) -> str:
+    """Short account line for the menu, e.g. "you@mail.com (pro)"."""
+    if not info.get("linked"):
+        return "not linked"
+    who = info.get("email") or ("API key" if "api" in info.get("method", "") else "signed in")
+    plan = info.get("plan")
+    return f"{who} ({plan})" if plan else who
+
+
+def is_auth_error(text: str) -> bool:
+    low = (text or "").lower()
+    return any(p in low for p in AUTH_ERRORS)
+
+
+def open_terminal(command: str) -> None:
+    """Run a command in a new visible PowerShell window (it stays open)."""
+    shell = shutil.which("pwsh") or shutil.which("powershell") or "powershell"
+    subprocess.Popen([shell, "-NoExit", "-Command", command],
+                     creationflags=CREATE_NEW_CONSOLE)
+
+
+def install() -> None:
+    """Install Claude Code with Anthropic's official installer."""
+    open_terminal(INSTALL_COMMAND)
+
+
+def login(claude: str | None, console: bool = False) -> None:
+    """Start Claude Code's browser sign-in.
+
+    Args:
+        claude: path of the CLI (found again when None).
+        console: sign in to the Anthropic Console (API credits) instead of
+            a Claude Pro/Max subscription.
+    """
+    exe = claude or find_claude() or "claude"
+    flag = "--console" if console else "--claudeai"
+    open_terminal(f"& '{exe}' auth login {flag}")
+
+
+def logout(claude: str | None) -> None:
+    exe = claude or find_claude() or "claude"
+    subprocess.run([exe, "auth", "logout"], capture_output=True, timeout=30,
+                   creationflags=CREATE_NO_WINDOW)

boba_pet-1.0.0/boba_pet.egg-info/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: boba-pet
+Version: 1.0.0
+Summary: Boba: an always-on-top desktop pet for Claude Code, Codex, Gemini and Groq on Windows.
+Author: Abdul Rahman Azam
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AbdulRahmanAzam/boba-pet
+Project-URL: Issues, https://github.com/AbdulRahmanAzam/boba-pet/issues
+Keywords: claude,claude-code,desktop-pet,ai-assistant,tkinter,windows
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Topic :: Desktop Environment
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.26
+Requires-Dist: sounddevice>=0.4
+Requires-Dist: vosk>=0.3.45
+Requires-Dist: faster-whisper>=1.0
+Requires-Dist: model2vec>=0.3
+Requires-Dist: tkinterdnd2>=0.4
+Dynamic: license-file
+
+# Boba Pet
+
+An always-on-top pixel-art desktop pet for Windows that talks to **Claude Code**
+(and Codex, Antigravity, Gemini or Groq). Click it, type or say "Hey Boba", and
+the answer pops up in a speech bubble. It watches your Claude Code sessions,
+reacts when they finish or fail, and keeps you on track with tasks, focus
+timers and a hackathon mode.
+
+## Install (one line)
+
+Open **PowerShell** and run:
+
+```powershell
+irm https://raw.githubusercontent.com/AbdulRahmanAzam/boba-pet/main/install.ps1 | iex
+```
+
+That's it. The installer:
+
+1. installs [uv](https://docs.astral.sh/uv/) if you don't have it,
+2. installs Boba Pet with its own private Python 3.12 (your Python is untouched),
+3. downloads the offline voice and search models (about 200 MB, one time),
+4. adds **Boba Pet** to the Start menu and starts the pet.
+
+No admin rights, no git clone. To also start the pet with Windows, run
+`$env:BOBA_PET_AUTOSTART="1"` before the line above, or later run
+`boba-pet-setup --autostart`.
+
+### Already have Python 3.11+?
+
+```powershell
+pip install boba-pet
+boba-pet
+```
+
+or, with [uv](https://docs.astral.sh/uv/), just `uvx boba-pet`. The first
+start downloads the voice models in the background; run `boba-pet-setup`
+once to get them right away and add a Start menu shortcut.
+### Update / uninstall
+
+```powershell
+uv tool upgrade boba-pet                       # update (or re-run the install line)
+boba-pet-setup --uninstall-shortcuts; uv tool uninstall boba-pet   # remove
+```
+
+Your settings and models stay in `%USERPROFILE%\.boba-pet` and
+`%USERPROFILE%\.claude-pet*.json`; delete them to remove everything.
+
+## Requirements
+
+- Windows 10 or 11
+- One AI to talk through (the pet has no key of its own; pick it from the
+  right-click menu > **AI provider**):
+  - [Claude Code](https://docs.claude.com/claude-code) (recommended):
+    `irm https://claude.ai/install.ps1 | iex`, then sign in once with `claude`
+  - Codex CLI (ChatGPT plan), Antigravity CLI (Google account), or a free
+    Groq / Gemini API key
+
+## What it does
+
+- **Chat** in a speech bubble; the chat keeps context, shows tokens used
+  (↑ input, ↓ output) and has a cheap **Compact** button that rolls the chat
+  into a short note.
+- **Quick menu**: click the ✱ in the ask box for ask, talk, screenshot, new
+  chat, compact, history, effort level and more.
+- **Voice, fully offline**: talk with the mic button (Whisper), say
+  "Hey Boba" to wake it (Vosk), and have replies read aloud (Windows TTS).
+- **Claude Code companion**: it looks busy while a session works, celebrates
+  when it finishes, sweats when tests fail and waves when Claude needs your
+  permission. A usage meter shows your plan limits and today's tokens.
+- **Projects**: "open my portfolio project" finds the folder and opens it in
+  VS Code with Claude Code running.
+- **Tasks, reminders and focus timer**, with a gentle distraction guard.
+- **Hackathons**: track deadlines, and click one for a workspace with a
+  checklist, notes, focus sprints, idea/pitch/judge helpers and a prompt coach
+  that suggests better Claude Code prompts while you build.
+- **Morning tech briefing** from real news feeds, every item linked to its source.
+- **Screenshots**: snip part of the screen and ask about it.
+- **Computer tools** (optional): the AI can open apps, change volume, type and
+  so on. By default it **asks you first** for anything risky; set the mode in
+  the menu, or turn it off.
+- **Characters**: several pixel-art pets; add your own with one file (see below).
+
+## Privacy
+
+- API keys you paste are saved only in `%USERPROFILE%\.boba-pet\.env` on your PC.
+- Speech recognition and the wake word run locally; audio never leaves the PC.
+- The pet reads Claude Code transcripts locally to react to sessions; their
+  text is not sent anywhere.
+- Requests to the AI go through the provider you linked, on your own account.
+
+## Run from source (for contributors)
+
+```powershell
+git clone https://github.com/AbdulRahmanAzam/boba-pet
+cd boba-pet
+uv venv --python 3.12 .venv
+uv pip install --python .venv\Scripts\python.exe -r requirements.txt
+.venv\Scripts\python.exe launch.py --setup   # optional: models + Start menu shortcut
+.venv\Scripts\pythonw.exe claude_pet.py
+```
+
+In a clone, the pet keeps `.env`, `models/` and `shots/` next to the code
+(all git-ignored). Copy `.env.example` to `.env` if you use Groq or Gemini keys.
+Set `BOBA_PET_PROJECTS` (folders separated by `;`) to choose where it looks
+for your projects.
+
+### Layout
+
+| File | What it is |
+|------|------------|
+| `claude_pet.py` | The pet window, menus, chat and everything that ties the parts together |
+| `providers.py`, `account.py` | Talking to Claude Code, Codex, Antigravity, Groq and Gemini |
+| `chatlog.py` | Chat history, token counts and compaction |
+| `sprites.py`, `sprite_*.py` | Pixel-art characters |
+| `listener.py`, `wake.py`, `speak.ps1` | Mic input (Whisper), wake word (Vosk), text to speech |
+| `cc_watch.py`, `pet_hook.py`, `pet_status.py`, `usage.py` | Claude Code session watching and usage meter |
+| `projects.py`, `vscode-ext/` | Project search and the VS Code launcher extension |
+| `tasks.py`, `focus.py` | Tasks, reminders, focus timer visuals |
+| `hackathons.py`, `hackmode.py` | Hackathon tracker and hackathon mode |
+| `news.py` | Morning briefing from RSS/Atom feeds |
+| `computer.py`, `pet_mcp.py` | Computer tools and their MCP server |
+| `snip.py`, `ui_fx.py` | Screen snipping, fades, markdown and other UI helpers |
+| `launch.py`, `pet_setup.py`, `pet_paths.py` | Installed command, first-run setup, data folders |
+
+### Add a character
+
+Drop a `sprite_<name>.py` file next to `sprites.py` with a
+`compose_<name>(...)` function (copy `sprite_bluebot.py` to start), an
+optional `NAME` for the menu and an optional `EXTRA_PALETTE`. It shows up in
+the menu on the next start.
+
+## Contributing
+
+Pull requests are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

boba_pet-1.0.0/boba_pet.egg-info/SOURCES.txt

@@ -0,0 +1,73 @@
+LICENSE
+README.md
+__init__.py
+__main__.py
+account.py
+cc_watch.py
+chatlog.py
+claude_pet.py
+computer.py
+focus.py
+hackathons.py
+hackmode.py
+launch.py
+listener.py
+news.py
+pet_hook.py
+pet_mcp.py
+pet_paths.py
+pet_setup.py
+pet_status.py
+projects.py
+providers.py
+pyproject.toml
+snip.py
+speak.ps1
+sprite_bluebot.py
+sprite_gentleman.py
+sprite_goggles.py
+sprites.py
+tasks.py
+ui_fx.py
+usage.py
+wake.py
+./__init__.py
+./__main__.py
+./account.py
+./cc_watch.py
+./chatlog.py
+./claude_pet.py
+./computer.py
+./focus.py
+./hackathons.py
+./hackmode.py
+./launch.py
+./listener.py
+./news.py
+./pet_hook.py
+./pet_mcp.py
+./pet_paths.py
+./pet_setup.py
+./pet_status.py
+./projects.py
+./providers.py
+./snip.py
+./speak.ps1
+./sprite_bluebot.py
+./sprite_gentleman.py
+./sprite_goggles.py
+./sprites.py
+./tasks.py
+./ui_fx.py
+./usage.py
+./wake.py
+./vscode-ext/extension.js
+./vscode-ext/package.json
+boba_pet.egg-info/PKG-INFO
+boba_pet.egg-info/SOURCES.txt
+boba_pet.egg-info/dependency_links.txt
+boba_pet.egg-info/entry_points.txt
+boba_pet.egg-info/requires.txt
+boba_pet.egg-info/top_level.txt
+vscode-ext/extension.js
+vscode-ext/package.json

boba_pet-1.0.0/boba_pet.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

boba_pet-1.0.0/boba_pet.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+boba-pet-setup = boba_pet.launch:setup
+
+[gui_scripts]
+boba-pet = boba_pet.launch:main

boba_pet-1.0.0/boba_pet.egg-info/requires.txt

@@ -0,0 +1,6 @@
+numpy>=1.26
+sounddevice>=0.4
+vosk>=0.3.45
+faster-whisper>=1.0
+model2vec>=0.3
+tkinterdnd2>=0.4

boba_pet-1.0.0/boba_pet.egg-info/top_level.txt

@@ -0,0 +1 @@
+boba_pet