Your PC's Personal Health Guardian & AI Performance Predictor
RigMaster AI is a next-generation web application designed for PC gamers and hardware enthusiasts. It solves two major problems: "Can I run it?" and "When should I clean it?"
Powered by Google's Gemini 1.5 Flash AI model, RigMaster predicts FPS values for any game configuration without relying on static databases. Additionally, it acts as a maintenance companion, tracking your thermal paste and fan cleaning schedules based on your specific device type (Laptop/Desktop).
- 🤖 AI-Powered FPS Predictor: Utilizes Google Gemini to estimate Low, Medium, and Ultra FPS for any game and hardware combination.
- 🛠️ Smart Maintenance Scheduler: Automatically calculates the next service date for Fan Cleaning and Thermal Paste replacement based on device type.
- 🔧 Custom Hardware Support: Don't see your GPU? No problem. The "Other / Custom" input allows manual entry for specific or legacy hardware.
- 📚 Interactive Guide Hub: Direct access to curated repair guides (iFixit, Tom's Hardware) for your specific form factor.
- 🌓 Dark & Light Mode: Fully responsive UI with a sleek, gamer-focused aesthetic.
- 💾 Local Persistence: Saves your rig profile locally so you never have to re-enter specs.
This project was built using modern web technologies focusing on performance and UX.
- Frontend: React.js (Vite Ecosystem)
- Language: TypeScript
- Styling: Tailwind CSS + Shadcn UI
- Icons: Lucide React
- AI Integration: Google Generative AI SDK (
@google/generative-ai) - Routing: React Router DOM
Follow these steps to run RigMaster AI locally on your machine.
- Node.js (v18 or higher)
- A Google Gemini API Key (Get it here)
-
Clone the repository
git clone [https://github.com/willbyers/rigmaster-ai.git](https://github.com/willbyers/rigmaster-ai.git) cd rigmaster-ai -
Install dependencies
npm install
-
Configure API Key Create a
.envfile in the root directory and add your Gemini API key:VITE_GEMINI_API_KEY=your_actual_api_key_here
-
Run the App
npm run dev
-
Open
http://localhost:5173in your browser.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Created By Mert Batu Bülbül
- 🎓 Computer Engineering Undergraduate * 💻 Full Stack Developer & AI Enthusiast *
Start tracking your rig's health today! 🖥️✨
Don't forget to star ⭐ this repo if you found it useful!