---
id: tuipet
version: "0.5.345"
license: MIT
license_treatment: permissive
maintenance: active
---

# tuipet — A terminal virtual pet (Digimon V-Pet style) rendered with halfblock sprites, built on data from the real devices.

License: permissive · Maintenance: active · Downloads: 339.6K/mo

## What it is and what it does

tuipet is a fully playable Digimon V-Pet emulator that runs in the terminal, rendering 1,548 creatures as Unicode halfblock sprites with 11 animation frames each. It faithfully recreates the real device's mechanics: hunger, sleep, filth, and effort tracking; training drills; evolution gated by care quality and battle records; armor evolution via shop-bought Digimentals; and a 26-zone Adventure mode with bosses, towns, and raid encounters. The game includes a calendar-driven tournament cup system, an in-game AI care assistant, and a classic four-tab shop.

Beyond single-player, tuipet adds online play: cloud-backed saves (one pet per device at a time, like a cartridge), a live lobby with chat, PvP battles, and two-player jogress fusion. The UI is built on textual and rich, fitting the entire game—pet arena, status card, and control strip—into a fixed LCD-style box. It runs on Linux, Android (including Termux), and iOS (via a-Shell), with sound support where available and graceful fallback to the terminal bell elsewhere.

Use it for:

- Play a faithful Digimon V-Pet emulator on any terminal without emulation software or ROM files.
- Raise and evolve a creature through care, training, and battle across 1,500+ forms using real device mechanics.
- Engage in PvP battles and two-player jogress fusion with other players in the online lobby.
- Collect all 1,548 creatures by unlocking divergence paths through DNA charging and field-specific evolution gates.
- Run a portable pet game on Android or iOS without a dedicated app store, using only a terminal and Python.
- Participate in community raid bosses and seasonal tournament cups on a real-calendar schedule.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A terminal-based virtual pet game in the Digimon V-Pet style, with Unicode sprite animation, care mechanics, evolution, adventure mode, and optional online multiplayer features.

Yes, if you want a terminal game. tuipet is actively maintained, has no security vulnerabilities, installs with low friction, and offers a complete, faithful V-Pet experience with both offline and online play. The MIT license is permissive. The only real constraint is Python 3.10+; iOS and Android both work with appropriate terminal apps. Start with a single-player save to learn the mechanics, then join the online lobby if you want multiplayer.

## Install

pip install tuipet
uv add tuipet
poetry add tuipet

## Installing tuipet

Before you install: Low install friction: pure Python wheel with no compiled dependencies. Active development with a commit from 2026-08-13 and regular updates. Requires Python 3.10+.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for personal or commercial projects.

Quickstart:

pip install tuipet
tuipet

# Or with pipx for isolation:
pipx install tuipet
tuipet

Requires Python 3.10 or later. On iOS, use a-Shell and run `python3 -m tuipet` instead of the bare command. On Android, optional termux-api package and Termux:API app enable sound.

Verify before relying:

- Whether online multiplayer features (lobby, PvP, jogress fusion) require account registration or authentication beyond local play.
- Whether save files sync automatically to the cloud or require manual upload.
- Performance characteristics on low-end terminals or over SSH with latency.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 339.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

terminal virtual pet game, digimon v-pet emulator, tui pet simulator, terminal tamagotchi, unicode sprite animation game, retro pet care game, terminal multiplayer pet, game, retro-emulation, multiplayer

[View on SkillFed](https://skillfed.io/packages/tuipet) · [View on PyPI](https://pypi.org/project/tuipet/)