AK-21/Graphite-Industrial-Intelligence

1---2title: Graphite Industrial Intelligence3emoji: 🏭4colorFrom: purple5colorTo: indigo6sdk: docker7pinned: false8---9 10# Graphite Industrial Intelligence11 12Graphite Industrial Intelligence is a state-of-the-art predictive maintenance and root-cause analysis platform designed for critical industrial infrastructure. It bridges the gap between raw hardware telemetry and unstructured technical documentation. 13 14Instead of operators having to cross-reference sensor alerts with 500-page OEM manuals, the platform ingests everything into a unified ecosystem. It uses AI to semantically search documents and visually map relationships in real-time.15 16## Key Features17 181. **Asset Registry:** Manage the digital twins of your industrial equipment. View live health statuses and track maintenance requirements.192. **Document Ingestion:** Upload technical manuals and standard operating procedures (SOPs). Files are instantly parsed, chunked, and vectorized for semantic search by the AI engine.203. **Interactive Knowledge Graph:** Visually explore complex relationships between physical assets, detected anomalies, and technical documentation. Run AI Root Cause Analysis directly from the visual interface.214. **AI Knowledge Q&A:** Chat directly with the Retrieval-Augmented Generation (RAG) pipeline to ask complex maintenance questions and get instant answers sourced and cited from your uploaded manuals.22 23## Technology Stack24 25* **Frontend:** React, Vite, Tailwind CSS, Framer Motion, React Flow (`@xyflow/react`)26* **Backend:** Node.js, Express, tRPC (Type-safe APIs)27* **Database:** SQLite (better-sqlite3) for local fast storage28* **AI & Embeddings:** Google Generative AI (Gemini)29 30---31 32## Getting Started33 34### Prerequisites35* Node.js (v18 or higher recommended)36* An active Google Gemini API Key. You must set this in your environment for the AI features (Q&A, Root Cause Analysis) to work.37 38### Installation39 401. **Clone the repository:**41   ```bash42   git clone https://github.com/AK-2110/Graphite-Industrial-Intelligence.git43   cd Graphite-Industrial-Intelligence44   ```45 462. **Set up Environment Variables:**47   * Navigate to the `server` directory and create a `.env` file:48     ```bash49     cd server50     # Create .env and add your Gemini API Key51     # GEMINI_API_KEY=your_api_key_here52     ```53 543. **Install Dependencies:**55   * Open two terminal windows.56   * **Terminal 1 (Backend):**57     ```bash58     cd server59     npm install60     ```61   * **Terminal 2 (Frontend):**62     ```bash63     cd client64     npm install65     ```66 67### Running the Application68 691. **Start the Backend Server:**70   In Terminal 1 (inside the `server` directory), run:71   ```bash72   npm run dev73   ```74   *(Alternatively, if `npm run dev` is not configured, run `npx tsx src/index.ts`)*75 762. **Start the Frontend Client:**77   In Terminal 2 (inside the `client` directory), run:78   ```bash79   npm run dev80   ```81 823. **Open the Application:**83   Open your browser and navigate to `http://localhost:5173` to access the Graphite Industrial Intelligence dashboard.84 85## Usage Workflow861. **Register Assets:** Start by adding your physical equipment in the Asset Registry.872. **Ingest Docs:** Upload technical manuals via the Document Ingestion module.883. **Detect Anomalies:** When an asset goes offline, open the Knowledge Graph to trace the failure.894. **Query AI:** Click on failing nodes or use the Q&A bot to extract exact repair procedures from your documentation.90