GrockTurbo

AI chat app powered by Groq, featuring a modern web interface and near-instant responses.

✨ Features

• ⚡ Fast: Near-instant inference speeds thanks to Groq's API
• 🌐 Efficient: Lightweight and responsive even on the slowest internet connections
• 🧠 Models: Choose from various LLMs including Qwen3, GPT-OSS, and Kimi K2
• 🔒 Private: Zero spyware or telemetry; only API requests leave your machine
• 💾 Persistent Storage: Chat history and settings saved locally

---

🚀 Quick Start

Prerequisites

• Git - Download from git-scm.com/downloads
• Node.js - Download from nodejs.org
• Groq API Key - For free at console.groq.com/keys

Installation

Clone or download the repository:

git clone https://github.com/Melyns/GrockTurbo.git
cd GrockTurbo

Windows:

# 1. Install dependencies
install.bat

# 2. Launch the app
run.bat

# (Optional) Launch in dev mode
dev.bat

Linux / macOS:

# Make scripts executable (first time only)
chmod +x *.sh

# 1. Install dependencies
./install.sh

# 2. Launch the app
./run.sh

# (Optional) Launch in dev mode
./dev.sh

Manual installation:

# 1. Install dependencies
npm install

# 2. Launch the app in dev mode
npm run dev

The application will open at http://127.0.0.1:9807/. On first launch, you'll be prompted to enter your Groq API key in the browser.

⚙️ Configuration

Port Configuration

Default port is 9807. To change it, modify port.cfg in the project root with your desired port number.

🏗️ Architecture

• Backend: Express with SQLite
• Frontend: React + Vite + Tailwind
  • State management with Zustand
  • UI feedback via sonner
  • Markdown rendering with react-markdown
  • Math support via KaTeX
  • Syntax highlighting for code blocks

👏 Acknowledgments

• Gemini for building this app
• Groq for the generous inference API

⚠️ Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Groq, Inc. All references to Groq are for informational purposes only.

---

📄 License

This project is licensed under the GPL-3.0 license - see the LICENSE file for details.