common-skills

Common Skills to zbiór wytycznych i list kontrolnych dla pakietu common/ — współdzielonych narzędzi Pythona używanych we wszystkich usługach LlamaFarm. Obejmuje integrację z HuggingFace Hub, zarządzanie modelami GGUF i wspólne funkcje. Skill zawiera wzorce kodowania, reguły typowania, testowania, obsługi błędów i bezpieczeństwa, a także szczegółowe checklist dla HuggingFace API, pobierania modeli i uwierzytelniania.

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.