Skip to content

CharlesWiiFlowers/MikuPet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌟 MikuPet - Your Desktop Diva Companion!

A virtual desktop pet inspired by Hatsune Miku. Always walk to the active window and you can drag her!

📸 Preview

MikuPet Demo Miku Walking Miku Walking to left Chatting with Miku

Features

  • ⭐ Follows the active window around your desktop.
  • Drag her around with your mouse
  • ⭐ Respond to simple text commands
  • ⭐ Super lightweight and made with love.

🔧 Quick setup installation

Note

Works only on Windows (for now). Mac and Linux may come later!

To run MikuPet on your system, follow these simple steps:

  1. 🐍 Make sure Python is installed.

    • Python 3 is required (any modern version should work).
    • You can download it from python.org
  2. 📂 Download the latest release

    • Go to the Releases section of this repository.
    • Download the .zip or .tar.gz file for the latest version.
    • Extract it to a folder of your choice.
  3. ⚙️ Install dependencies
    Open a terminal (or command prompt), navigate to the extracted folder, and run:

    pip install -r requirements.txt
  4. 🏁 Run the app Simply double-click on start.bat to launch the app. A console window will open — this is where you can type commands to interact with Miku (for example, miku bye to exit).

🖱️ Usage

Using MikuPet is super simple:

  1. Double-click on start.bat to launch the app.
  2. Miku will appear on your desktop, floating and moving cutely.
  3. A terminal window will open — this is your way to chat with Miku!

🗣️ Available Commands

You can type the following commands into the console:

🖥️ Command 🧵 Description
miku hello or hello Miku will greet you warmly 💙
miku bye or bye Closes MikuPet gracefully 👋
how are you (variants) Miku responds to your question 🤖🎶
Accepted forms: how are you, how are you?, miku how are you

More commands coming soon... maybe even little surprises! 🎁✨


🛠️ Built with

  • 🐍 Python 3
  • 🖥️ Tkinter
  • 🎨 Pixel Art Sprites

🌱 Roadmap

  • Miku speaks and sings at random moments.
  • Mini desktop games.
  • Feed Miku!
  • More characters like Teto, Rin and Len!
  • AI and IoT integration!

🌟 Credits


💘 Thank you for visiting!

Have fun chatting with your digital desktop diva 💫

🎶 Life is a melody you compose at your own tempo. Let MikuPet be your rhythm compation for every line of code. 🖥️✨