🎯 MOMOKA

AIエージェント型DiscordBOT — PLANA + ARONA のデュアルボット構成。AIチャット・音楽・画像生成・討論など。

🇯🇵 日本語 (Japanese) | 🇺🇸 English

---

✨ What is MOMOKA?

MOMOKA runs two Discord bots in one process: PLANA (primary) and ARONA (companion). Each can run alone for LLM chat and music. Debate / cross-check need both bots in the same guild. TTS, image generation, notifications, and trackers are PLANA only (ARONA redirects users to PLANA).

Built-ins:

• Built-in image generation — diffusers pipeline in MOMOKA/generator/image
• Integrated Style-Bert-VITS2 TTS — see MOMOKA/generator/tts and NOTICE (AGPL/LGPL)

🚀 Key Features

• 🤖 AI Chat (LLM) — Mention @PLANA / @ARONA. OpenAI, Gemini, NVIDIA NIM, KoboldCPP + API key rotation
• 🗣️ debate / cross_check — Multi-round PLANA↔ARONA debate with judge, or a light 3-step cross-check
• 🎵 Music — YouTube, Spotify, and more (both bots)
• 🎨 Image Generation / TTS / Notifications / Trackers — PLANA only
• 🎲 Utilities — /help and /invite (Components V2), dice, timers, and more

📋 Quick Start

1. Clone

   git clone https://github.com/coffin399/ProjectMOMOKA.git
   cd ProjectMOMOKA

2. Requirements

   • Python 3.11.x (required)
   • Two Discord Applications (PLANA + ARONA), both with Message Content Intent
   • Optional: Netscape-format youtube_cookie.txt in the project root

3. Configure (configs/ — root config.yaml is not used)

   • First run copies configs/<category>_config.default.yaml → configs/<category>_config.yaml automatically (or copy manually)
   • Edit configs/bots_config.yaml: set bots.plana.token and bots.arona.token
   • Edit configs/llm_config.yaml for API keys
   • Invite both bots:
     • PLANA
     • ARONA

4. Run

   startMOMOKA.bat          # Windows (recommended)
   # or: py -3.11 -m venv .venv && pip install -r requirements.txt && python main.py

📚 Docs

• 🇯🇵 日本語詳細 · 🇺🇸 English

🔧 Third-Party / License

• Project license: AGPL-3.0
• Style-Bert-VITS2 integrated under AGPL-3.0 / LGPL-3.0 — see NOTICE and MOMOKA/generator/tts/LICENSE_SBVITS2*

---

Made with ❤️ by the MOMOKA development team