common-skills

Best practices for the Common utilities package in LlamaFarm. Covers HuggingFace Hub integration, GGUF model management, and shared utilities.

1. Zainstaluj pakiet llamafarm-common w swoim projekcie LlamaFarm, upewniając się, że używasz Pythona 3.10 lub nowszego oraz że masz zainstalowane zależności: huggingface_hub i hf-transfer.
2. Zapoznaj się z dokumentacją wspólnych umiejętności Pythona — przejrzyj pliki dotyczące wzorców kodowania, type hints, testowania i obsługi błędów, aby zrozumieć standardy obowiązujące w całym projekcie.
3. Gdy pracujesz z modelami GGUF lub integracją HuggingFace Hub, otwórz plik huggingface.md i zastosuj checklist dla Hub API, pobierania modeli, cache'owania i uwierzytelniania.
4. Sprawdzaj moduł model_utils.py pod kątem dostępnych funkcji do wyboru plików GGUF i parsowania parametrów kwantyzacji — używaj tych narzędzi zamiast pisać własną logikę.
5. Podczas code review lub pisania nowych funkcji w pakiecie common/ odwołuj się do list kontrolnych dotyczących bezpieczeństwa (walidacja ścieżek, bezpieczna obsługa plików) i zarządzania procesami (pliki PID).
6. Upewnij się, że wszystkie nowe funkcje w common/ są eksportowane w __init__.py i są dostępne dla innych usług LlamaFarm — zachowaj spójność API między modułami.