Repository navigation
Releases
screenpet 0.1.0
A desktop pet that reads your screen with local OCR and answers with a local Ollama model. Nothing about your screen leaves the machine — see Verify the privacy claim for how to check that rather than take it on trust.
First release. Windows 10/11, 64-bit.
Downloads
screenpet-0.1.0-setup.exe |
Installer. Adds a Start menu entry and gets in-app updates. |
screenpet-0.1.0-portable.exe |
Single file, runs from anywhere, no install. |
latest.yml and the blockmap are for the in-app updater. You don't need to download them.
Windows will warn you, and it is right to
These binaries are not code signed, so SmartScreen shows "Windows protected your PC". To run anyway: More info → Run anyway.
That warning is honest — it means Windows has never seen this publisher before, which is true. A certificate costs money this project doesn't have yet; an application is in with the SignPath Foundation, who sign open source projects for free. The project moved to MIT for exactly that reason.
If that trade isn't one you want to make, the source is right here and npm run dist builds the same thing on your own machine.
What it needs
- Nothing, to run. It eats, sleeps, wanders, chats, sulks, dances and takes water breaks with no model installed at all.
- Ollama, to read your screen. That is the only part gated on it.
ollama pull deepseek-r1:8band the reading half switches itself on. The settings window will tell you which of your installed models it would pick, and why. - Optional: a Piper voice for a better voice than Windows', and whisper.cpp or Parakeet for dictation. Both are folders you drop files into — see the README.
In this release
- Ten pets, ten skins, a wardrobe, forty faces, and a house it walks out of on launch
- Reading the screen on a hotkey, or on a timer, with a vision tier for diagrams
- Talking to it by voice, and — with one setting on — a conversation rather than a click per sentence
- Water and rest breaks, timers, reminders, memory, skills
- Sing at it and it dances
Full list in CHANGELOG.md. Why any of it works the way it does is DESIGN.md.
Known ceilings
- Windows only. The macOS helper is Swift that has never been compiled anywhere, so there is no macOS build rather than a broken one.
- Unsigned, as above.
- Reading needs Ollama running locally; there is no hosted fallback unless you switch one on deliberately, and doing so is what sends screen text off the machine.