lfs.md

Konfiguracja Git LFS dla bazy danych LanceDB

Twoja baza danych LanceDB znajduje się w folderze lancedb. Folder ten może być bardzo duży i zawierać wiele małych plików, co jest nieefektywne do przechowywania bezpośrednio w repozytorium Git. Aby prawidłowo zarządzać tym folderem i móc go wypchnąć na Hugging Face Spaces (które wspiera Git LFS), musisz skonfigurować Git LFS (Large File Storage).

Git LFS to rozszerzenie do Git, które pozwala na efektywne zarządzanie dużymi plikami. Zamiast przechowywać duży plik bezpośrednio w repozytorium Git, Git LFS przechowuje w nim mały wskaźnik do tego pliku, a rzeczywisty duży plik jest przechowywany na zdalnym serwerze LFS.

Poniżej znajdziesz instrukcje krok po kroku.

---

Instrukcje

1. Zainstaluj Git LFS (jeśli jeszcze tego nie zrobiłeś)

Git LFS jest dostępny na większości systemów operacyjnych. Najpierw sprawdź, czy masz go zainstalowanego, uruchamiając w terminalu:

git lfs version

Jeśli Git LFS nie jest zainstalowany, odwiedź oficjalną stronę, aby pobrać i zainstalować pakiet dla Twojego systemu: git-lfs.github.com

2. Zainicjuj Git LFS w Twoim repozytorium

Po zainstalowaniu Git LFS, musisz go zainicjować w swoim repozytorium. Otwórz terminal w katalogu głównym swojego projektu (C:\Users\jacza\JacekAI) i wykonaj komendę:

git lfs install

Ta komenda jednorazowo konfiguruje Git LFS dla Twojego lokalnego repozytorium.

3. Wskaż Git LFS, które pliki mają być śledzone

Teraz musisz poinformować Git LFS, które pliki (lub wzorce plików) powinien śledzić. W Twoim przypadku chcesz śledzić całą zawartość folderu lancedb. Wykonaj komendę w katalogu głównym projektu:

git lfs track "lancedb/**"

• Wyjaśnienie: Ta komenda tworzy (lub aktualizuje) plik .gitattributes w katalogu głównym projektu. Plik ten zawiera regułę, która nakazuje Git LFS śledzenie wszystkich plików znajdujących się w folderze lancedb i jego podkatalogach (lancedb/**).
• Ważne: Upewnij się, że plik .gitattributes został dodany do Twojego repozytorium. Sprawdź jego zawartość (powinna wyglądać mniej więcej tak: lancedb/** filter=lfs diff=lfs merge=lfs -text).

4. Dodaj zmiany, zatwierdź i wypchnij do zdalnego repozytorium

Po skonfigurowaniu Git LFS, możesz dodać, zatwierdzić i wypchnąć swoje zmiany jak zwykle. Git LFS automatycznie zajmie się dużymi plikami w tle, zastępując je w repozytorium Git małymi wskaźnikami.

git add .
git commit -m "Configure Git LFS for LanceDB and push application"
git push

Po wykonaniu tych kroków Twoje repozytorium będzie przygotowane do efektywnego zarządzania bazą danych LanceDB, a Ty będziesz mógł je bez problemu wypchnąć na Hugging Face Spaces.