ghealth: Nowe narzędzie CLI dla Google Health API ułatwia integrację danych zdrowotnych z AI

Google Health API, które zastąpiło Fitbit Web API, doczekało się nowego, otwartego narzędzia wiersza poleceń o nazwie ghealth. Narzędzie to, będące nakładką na Google Health API w wersji 4, ma na celu ułatwienie deweloperom i agentom sztucznej inteligencji dostęp do danych zdrowotnych z urządzeń takich jak Fitbit i Pixel Watch, wykorzystując przy tym standard Google OAuth 2.0.

Architektura i funkcjonalność ghealth

ghealth to pojedynczy plik binarny napisany w języku Go, udostępniony na licencji Apache 2.0. Jego kluczową cechą jest ekspozycja 40 zweryfikowanych typów danych w ustrukturyzowanym formacie JSON. Dzięki temu dane dotyczące snu, tętna czy liczby kroków mogą być łatwo przesyłane do kontekstu agentów AI. Narzędzie zostało zaprojektowane jako "agent-first", co podkreśla jego przeznaczenie do integracji z systemami sztucznej inteligencji. Każde polecenie zwraca uproszczony JSON o stabilnej strukturze, a także oferuje deterministyczne kody wyjścia, flagę --dry-run do testowania oraz --raw do uzyskiwania oryginalnej odpowiedzi API.

Repozytorium ghealth zawiera również dwie "Agent Skills" w postaci plików SKILL.md. Jedna z nich obejmuje uwierzytelnianie, konfigurację i globalne flagi, natomiast druga dokumentuje wszystkie 40 typów danych, operacje, wzorce i potencjalne pułapki. Agenci mogą je zainstalować za pomocą npx skills add ..

Obsługiwane typy danych i operacje

ghealth obsługuje większość sygnałów z urządzeń Fitbit i Pixel Watch. Wśród 40 typów danych znajdują się m.in.:

• steps (kroki)
• heart-rate (tętno)
• sleep (sen)
• weight (waga)
• oxygen-saturation (saturacja tlenu)
• heart-rate-variability (zmienność rytmu serca)

Typy kliniczne, takie jak electrocardiogram (elektrokardiogram), wymagają specjalnego zakresu uprawnień ecg.readonly. Każdy typ danych obsługuje podzbiór operacji. Do najczęściej spotykanych należą list, rollup, daily-rollup i reconcile. Typy danych, które można zapisywać (takie jak exercise, sleep, weight, body-fat, height), dodatkowo wspierają operacje create, update i delete.

Operacja reconcile jest szczególnie interesująca, ponieważ łączy nakładające się punkty danych z wielu źródeł, odzwierciedlając funkcjonalność "Reconciled Stream" w API v4. Przykładem zaawansowanej analizy jest obsługa danych dotyczących snu: domyślna lista zwraca podsumowanie, natomiast flaga --detail pozwala uzyskać dane etap po etapie (np. faza czuwania, snu głębokiego, REM), co ułatwia analizę wzorców w dłuższej perspektywie.

Konfiguracja i bezpieczeństwo

Konfiguracja ghealth jest prosta i odbywa się za pomocą pojedynczego polecenia: ghealth setup. Kreator przeprowadza użytkownika przez proces konfiguracji projektu GCP i OAuth. Użytkownik musi utworzyć klienta OAuth typu Desktop w Google Cloud Console. Narzędzie nie przechowuje żadnych współdzielonych kluczy, a użytkownik dostarcza własne poświadczenia OAuth. Pliki konfiguracyjne są zapisywane w katalogu ~/.config/ghealth/ z uprawnieniami 0600, a tokeny odświeżają się automatycznie.

Wszystkie zakresy Google Health API są sklasyfikowane jako Restricted (ograniczone). Wymaga to przeglądu prywatności i bezpieczeństwa przez Google w przypadku dostępu produkcyjnego. Do użytku osobistego wystarczy autoryzacja własnego projektu na własnym koncie. API zwraca dane z urządzeń Fitbit, Pixel Watch oraz podłączonych źródeł zewnętrznych. Przepływ bezgłowy (headless flow) wykorzystuje PKCE z wyzwaniem S256 i waliduje losowy parametr stanu po zakończeniu.

Przykłady użycia i porównanie

Odczyt danych jest spójny dla wszystkich typów. Każdy odczyt zwraca obiekt z wierszami w sekcji dataPoints. Przykładowe polecenia to:

• ghealth data heart-rate list --from today --limit 10 (ostatnie odczyty tętna)
• ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29 (dzienne sumy kroków)
• ghealth data sleep list --limit 5 --detail (etapy snu z ostatnich pięciu nocy)

Domyślnie dane wyjściowe są uproszczone, ale flaga --raw pozwala uzyskać oryginalną odpowiedź API. Możliwe jest również formatowanie danych do CSV lub tabeli za pomocą --format csv lub --format table. Flaga -o zapisuje dane do pliku i wyświetla podgląd schematu. Paginacja jest bezstratna, a duże listy zwracają nextPageToken, który można wykorzystać do pobrania kolejnych stron.

ghealth wyróżnia się na tle innych narzędzi CLI, które często są nieoficjalne. Podczas gdy bezpośrednie API REST oferuje pełną kontrolę, ghealth znacząco redukuje złożoność uwierzytelniania i formatowania danych, co czyni go idealnym rozwiązaniem do zastosowań w terminalu i z agentami AI.

Michal Sutter, specjalista ds. data science z tytułem magistra z Uniwersytetu w Padwie, jest autorem tego narzędzia. Jego doświadczenie w analizie statystycznej, uczeniu maszynowym i inżynierii danych pozwoliło na stworzenie narzędzia, które przekształca złożone zbiory danych w użyteczne informacje.

Znaczenie dla ekosystemu zdrowia cyfrowego

Wprowadzenie ghealth stanowi istotny krok w demokratyzacji dostępu do danych zdrowotnych. Upraszczając interakcję z Google Health API, narzędzie to może przyspieszyć rozwój innowacyjnych aplikacji i usług opartych na sztucznej inteligencji w sektorze zdrowia. Możliwość łatwego pozyskiwania i analizowania danych z urządzeń noszonych otwiera nowe perspektywy dla spersonalizowanej opieki zdrowotnej, monitorowania stanu zdrowia i badań naukowych, jednocześnie podkreślając rosnące znaczenie otwartych narzędzi w ekosystemie technologicznym.

Źródło: marktechpost.com