Kemoverse

A gacha-style bot for the Fediverse built with Python. Users can roll for characters, trade, duel, and perhaps engage with popularity-based mechanics. Currently designed for use with Misskey. Name comes from Kemonomimi and Fediverse.

📝 Docs

👉 Start reading the docs

🤌 Install instructions for those in a rush

🔧 Features

✅ Implemented

• 🎲 Character roll system
• 🧠 Core database structure for cards
• 📦 Basic support for storing pulls per player
• ⏱️ Time-based limitations on rolls
• ⚠️ Explicit account creation/deletion

🧩 In Progress

• 📝 Whitelist system to limit access

🧠 Roadmap

See our v2.0 board for more details

🛒 Gameplay & Collection

• 🔁 Trading system between players
• ⭐ Favorite characters (pin them or set profiles)
• 📢 Public post announcements for rare card pulls
• 📊 Stats for cards
• 🎮 Games to play
  • ⚔️ Dueling
• 🧮 Leaderboards
  • Most traded cards
  • Most owned cards
  • Most voted cards
  • Most popular cards (via usage-based popularity metrics)
  • Users with the rarest cards

🎨 Card Aesthetics

• 🖼️ Simple card template for character rendering
• 🌐 Web app to generate cards from images

🌍 Fediverse Support

✅ Anyone from the fediverse can play, but the server only works using a Misskey instance. Want to rewrite the program in Elixir for Pleroma? Let us know!

🗃️ Tech Stack

• Python (3.12+)
• SQLite
• Fediverse API integration (via Misskey endpoints)
• Flask
• Modular DB design for extensibility

💡 Philosophy

The bot is meant to feel light, fun, and competitive. Mixing social, gacha and duel tactics.