Knowhere

Intelligent GitHub Project Intelligence & Portfolio Tracker

A real-time GitHub telemetry cockpit and intelligent project dashboard. Track repository commit velocity, automated CI/CD pipeline health, issue resolution times, and generate AI-powered repository summaries with Google Gemini.

---

🌐 Overview

Knowhere is a developer intelligence dashboard designed to monitor and organize sprawling software ecosystems. By integrating GitHub REST and GraphQL APIs with client-side reactive charts and optional Google Gemini AI synthesis, Knowhere turns chaotic git histories into structured, actionable engineering insights.

---

✨ Key Features

• 📊 Real-Time Commit & Velocity Tracking: Visual commit heatmaps, language distribution breakdowns, and branch activity timelines.
• 🤖 AI Repository Summarizer: Integrated @google/generative-ai SDK generates executive release notes and changelog recaps from recent commits.
• ✨ 3D Parallax Interface: Interactive repository cards with 3D tilt effects (react-parallax-tilt), quick search palettes (cmdk), and smooth Framer Motion layout transitions.
• 🐳 Multi-Stage Docker Containerization: Pre-configured Alpine Nginx container ready for instant production deployment with docker-compose.yml.
• ⚡ Windows Launcher Scripts: Includes INSTALL.bat, Run_Project.bat, and UNINSTALL.bat for seamless local setup.

---

🏗️ Tech Stack & Directory Structure

Knowhere/
├── src/
│   ├── assets/             # Vector icons and hero graphics
│   ├── components/         # Repository cards, AI summarizer modal, commit charts
│   ├── store.ts            # Zustand global state store
│   ├── App.tsx             # Main dashboard layout
│   └── main.tsx            # Application bootstrap
├── public/                 # Favicons and manifest assets
├── Dockerfile              # Production multi-stage Nginx container
├── docker-compose.yml      # Docker compose configuration
├── INSTALL.bat             # Windows one-click installation script
├── Run_Project.bat         # Windows automated launcher
└── package.json            # Project dependencies and build scripts

---

🚀 Quick Start

1. Local Development

# Clone the repository
git clone https://github.com/Ares19v/Knowhere.git
cd Knowhere

# Install dependencies
npm install

# Start Vite dev server
npm run dev

2. Docker Compose Deployment

docker compose up -d --build

Access Knowhere at http://localhost:80 (or http://localhost:5173 in development mode).

---

📄 License

Distributed under the MIT License. See LICENSE for details.