From 146dca50a8a15bcd3528ba3286f4cf289f018639 Mon Sep 17 00:00:00 2001
From: kamici <kaziuciolek@outlook.com>
Date: Mon, 2 Feb 2026 13:24:11 +0000
Subject: [PATCH] Update README.md

---
 README.md | 89 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 85 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 12920b6..b8ab5c7 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,88 @@
-# Tauri + Vue + TypeScript
+# TrainHub 🏋️‍♂️
 
-This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
+**TrainHub** to zaawansowany asystent treningowy, wspierany przez lokalną sztuczną inteligencję. Aplikacja łączy planowanie treningów, monitorowanie parametrów medycznych oraz analizę postawy w czasie rzeczywistym.
 
-## Recommended IDE Setup
+Zbudowany przy użyciu **Tauri 2.0**, **Vue 3**, **TypeScript** oraz **Rust**.
 
-- [VS Code](https://code.visualstudio.com/) + [Vue - Official](https://marketplace.visualstudio.com/items?itemName=Vue.volar) + [Tauri](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode) + [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)
+## 🚀 Kluczowe Funkcje
+
+* **AI Coach & Chat**: Inteligentny asystent treningowy, który odpowiada na pytania dotyczące ćwiczeń i zdrowia (wykorzystuje Local LLM).
+* **Posture Analysis**: Analiza poprawności wykonywania ćwiczeń i postawy ciała w czasie rzeczywistym przy użyciu wizji komputerowej (moduł `posture/`).
+* **Smart Workout Tracking**: Zarządzanie planami treningowymi, śledzenie postępów i historia ćwiczeń (baza SQLite).
+* **Medical Metrics**: Monitorowanie parametrów zdrowotnych i statystyk witalnych.
+
+## 🛠️ Wymagania Wstępne
+
+1. **Node.js** (v18+)
+2. **Rust** (najnowsza wersja stabilna)
+3. **Build Tools for Visual Studio** (wymagane dla kompilacji C++/Rust na Windows).
+4. **Karta graficzna NVIDIA** (Zalecane dla modułu analizy postawy i płynnego czatu).
+
+## ⚙️ Instalacja i Uruchomienie
+
+1. **Sklonuj repozytorium:**
+```bash
+git clone https://git.kciolek.pl/kamici/TrainHub.git
+cd trainhub
+```
+
+
+2. **Zainstaluj zależności:**
+```bash
+npm install
+```
+
+
+3. **Uruchom tryb deweloperski:**
+```bash
+npm run tauri dev
+```
+
+
+
+---
+
+## 🤖 Konfiguracja AI (Instalacja Manualna)
+
+⚠️ **WAŻNE:** Aby moduły **AI Coach** oraz **Posture Analysis** działały, musisz ręcznie pobrać silnik wykonawczy `llama.cpp`. W obecnej fazie rozwoju (Alpha) te pliki nie są pobierane automatycznie.
+
+### Krok 1: Pobierz wymagane pliki
+
+Pobierz poniższe archiwa `.zip` (wersja `b7907`, CUDA 12.4):
+
+1. 📥 **Pliki wykonywalne (Binaries):**
+[llama-b7907-bin-win-cuda-12.4-x64.zip](https://github.com/ggml-org/llama.cpp/releases/download/b7907/llama-b7907-bin-win-cuda-12.4-x64.zip)
+2. 📥 **Biblioteki CUDA (Backend):**
+[cudart-llama-bin-win-cuda-12.4-x64.zip](https://github.com/ggml-org/llama.cpp/releases/download/b7907/cudart-llama-bin-win-cuda-12.4-x64.zip)
+
+
+### Krok 2: Instalacja plików
+
+1. W folderze aplikacji znajdź katalog `src-tauri`.
+2. Wypakuj zawartość **obu** pobranych archiwów do tego katalogu.
+3. Upewnij się, że plik `llama-server.exe` oraz biblioteki DLL znajdują się w jednym miejscu.
+
+
+---
+
+## 🏗️ Struktura Projektu
+
+* `src/app/` - Główna logika Frontend (Vue 3)
+* `components/chat/` - Interfejs czatu z trenerem AI.
+* `components/posture/` - Komponenty wizualizacji i analizy postawy (Canvas).
+* `composables/` - Logika biznesowa (np. `useAnalysis.ts`, `useActiveWorkout.ts`).
+
+
+* `src-tauri/` - Backend (Rust)
+* `src/db.rs` - Obsługa bazy danych SQLite (zapisywanie treningów).
+* `src/main.rs` - Punkt wejścia aplikacji i rejestracja komend.
+
+
+
+## 📄 Licencja
+
+Ten projekt jest udostępniony na licencji **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)**.
+
+Możesz używać i modyfikować kod do celów prywatnych i edukacyjnych. Użycie komercyjne (sprzedaż aplikacji lub usług na niej opartych) jest zabronione bez zgody autora.
+
+Pełny tekst licencji: [https://creativecommons.org/licenses/by-nc-sa/4.0/](https://creativecommons.org/licenses/by-nc-sa/4.0/)
\ No newline at end of file