🎮 Minecraft Mod Assistant

Your personal AI-powered companion for discovering, researching, and downloading Minecraft mods directly to your desktop!

---

✨ Overview

Minecraft Mod Assistant is a native Windows desktop application built to streamline your Minecraft modding experience. Instead of endlessly scrolling through forums or websites, simply ask the AI!

Powered by Mistral AI and packaged in a beautiful, modern UI using CustomTkinter, this app allows you to research mods, get recommendations, and even automatically download them directly to your computer with a single command.

---

🚀 Key Features

• 🤖 AI Agent Integration: Ask questions naturally. Example: "What does the Sodium mod do?"
• 📦 Direct Downloading: Say "Download sodium for fabric 1.21.1" and the app fetches and saves the .jar file directly to your local mods/ folder!
• 🎨 Modern Dark/Light Mode UI: The app automatically matches your Windows system theme for a seamless, sleek look.
• ⚡ Multithreaded Performance: The UI remains snappy and responsive even while the AI is "thinking" or downloading large files.

---

🛠️ Installation & Setup

If you want to run the app from the source code, follow these steps:

1. Prerequisites

Ensure you have Python 3.10 or higher installed.

2. Clone & Install Dependencies

Open your terminal in the project directory and run these command gradually:

python -m venv venv 

/venv/Scripts/activate.bat

pip install -r requirements.txt

3. Environment Variables (Important!)

You need an API key for the AI to function. Create a .env file in the root directory and add your Mistral API key with same variable name:

MISTRAL_API_KEY=your_api_key_here (get api key from: https://docs.mistral.ai)

4. Run the App

double click app.bat

You are done! ( ˶ˆᗜˆ˵ )

💡 How to Use

1. Launch the ModAssistantApp.
2. Type your query in the bottom text box.
   • Example: "Give me the link to Wizards of Lua"
   • Example: "Download Iris for fabric 1.20"
3. Wait for the Assistant to respond.
4. If you requested a download, click the shiny green 📁 Open Download Folder button to instantly see your new .jar file!

---

🏗️ Technologies Used

• CustomTkinter - For the gorgeous, responsive desktop UI.
• smolagents - To power the Tool Calling Agent architecture.
• LiteLLM - For seamless integration with the Mistral API.

Built with ❤️ for the Minecraft community.
Owner's discord:https://discord.com/users/ryzn_linex