{"id":51534000,"url":"https://github.com/swarmclawai/tamago-ai","last_synced_at":"2026-07-09T06:30:47.474Z","repository":{"id":349546012,"uuid":"1202804769","full_name":"swarmclawai/tamago-ai","owner":"swarmclawai","description":"AI-powered virtual desktop pet with pixel art, LLM chat personality, and Electron packaging. Inspired by classic 90s virtual pet toys.","archived":false,"fork":false,"pushed_at":"2026-04-06T12:25:39.000Z","size":167,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T14:35:37.308Z","etag":null,"topics":["ai","chatbot","desktop-app","electron","llm","nextjs","ollama","pet-simulator","pixel-art","react","retro-gaming","tailwindcss","typescript","virtual-pet"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/swarmclawai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-06T12:21:15.000Z","updated_at":"2026-04-06T12:25:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/swarmclawai/tamago-ai","commit_stats":null,"previous_names":["swarmclawai/tamago-ai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/swarmclawai/tamago-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Ftamago-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Ftamago-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Ftamago-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Ftamago-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swarmclawai","download_url":"https://codeload.github.com/swarmclawai/tamago-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Ftamago-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35290235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatbot","desktop-app","electron","llm","nextjs","ollama","pet-simulator","pixel-art","react","retro-gaming","tailwindcss","typescript","virtual-pet"],"created_at":"2026-07-09T06:30:46.975Z","updated_at":"2026-07-09T06:30:47.466Z","avatar_url":"https://github.com/swarmclawai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tamago.ai\n\nAn AI-powered virtual pet that lives on your desktop. Raise it, feed it, play with it, and chat with it. Each pet develops a unique personality based on how you care for it.\n\nInspired by the classic virtual pet toys of the 90s, rebuilt with modern AI. This was a fun weekend project exploring the intersection of LLM-powered characters and retro pixel art aesthetics.\n\n\u003c!-- Add your own gameplay screenshot here --\u003e\n\u003c!-- ![Tamago.ai Gameplay](docs/screenshots/gameplay.png) --\u003e\n\n## Features\n\n- **AI-Powered Personality** - Your pet responds to actions and chats using an LLM (Ollama Cloud). Its personality evolves based on how you interact with it\n- **Multiple Species** - Each egg hatches into a random species (Blob, Cat, or Mech), each with unique pixel art sprites and personality tendencies\n- **5 Evolution Stages** - Watch your pet grow from egg to baby to child to teen to adult, each with distinct sprites and communication styles\n- **Real-time Stats** - Manage hunger, happiness, energy, and hygiene. Neglect your pet and it will notice\n- **Retro LCD Aesthetic** - CSS box-shadow pixel art, scanline effects, and chiptune sounds in an egg-shaped device frame\n- **Offline Persistence** - Your pet ages while you're away. Come back to catch-up decay and evolved creatures\n- **Desktop App** - Runs as a standalone Electron app with system tray and native notifications when your pet needs attention\n\n\u003c!-- Add your own chat screenshot here --\u003e\n\u003c!-- ![Chat with your pet](docs/screenshots/chat.png) --\u003e\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18+\n- An [Ollama Cloud](https://ollama.com) API key (or local Ollama instance)\n\n### Setup\n\n```bash\n# Install dependencies\nnpm install\n\n# Create .env.local with your Ollama config\ncat \u003e .env.local \u003c\u003c 'EOF'\nOLLAMA_API_URL=https://ollama.com/api\nOLLAMA_API_KEY=your_api_key_here\nOLLAMA_MODEL=gemma3:4b\nEOF\n\n# Run in browser\nnpm run dev\n\n# Or run as desktop app\nnpm run electron:dev\n```\n\n### Building the Desktop App\n\n```bash\nnpm run electron:build\n```\n\nThis generates a `.dmg` (macOS) or `.exe` (Windows) in `dist-electron/`.\n\n## Tech Stack\n\n- **Frontend** - Next.js 16, React 19, Tailwind CSS v4\n- **AI** - Ollama Cloud API (gemma3:4b or any compatible model)\n- **Desktop** - Electron with system tray and native notifications\n- **Pixel Art** - Pure CSS box-shadow rendering (no image assets)\n- **Sound** - Web Audio API procedural synthesis\n- **State** - React Context + useReducer with localStorage persistence\n\n## How It Works\n\nYour pet's personality is shaped by your interactions:\n\n| Interaction Pattern | Resulting Traits |\n|---|---|\n| Lots of feeding | Foodie |\n| Lots of playing | Playful |\n| Frequent chatting | Philosophical |\n| Consistent care | Loving, Cheerful |\n| Neglect | Sassy, Anxious, Grumpy |\n\nEach species also has inherent trait tendencies:\n- **Blob** - Cheerful, Playful\n- **Cat** - Independent, Sassy\n- **Mech** - Philosophical, Independent\n\nThe LLM receives the pet's current stats, personality traits, bond level, and evolution stage as context, producing responses that match the pet's character.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswarmclawai%2Ftamago-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswarmclawai%2Ftamago-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswarmclawai%2Ftamago-ai/lists"}