langfuse-local-dev-loop

Umożliwia ci skonfigurowanie lokalnego środowiska deweloperskiego z Langfuse, gdzie zmiany w kodzie natychmiast się przeładowują, a ślady wykonania są widoczne bez opóźnień. Skill automatyzuje przygotowanie pliku konfiguracyjnego, integrację bibliotek OpenTelemetry i Langfuse, oraz opcjonalne uruchomienie samodzielnie hostowanej instancji Langfuse przez Docker. Idealne do iteracyjnego tworzenia i debugowania aplikacji opartych na modelach językowych, gdzie szybka informacja zwrotna jest kluczowa.

1. Upewnij się, że masz ukończoną konfigurację z umiejętności langfuse-install-auth oraz zainstalowany Node.js 18 lub nowszy z pakietem tsx (npm install -D tsx). Docker jest opcjonalny, jeśli planujesz uruchomić lokalną instancję Langfuse.

2. Skill utworzy plik .env.local (ignorowany przez Git) z kluczami publicznym i prywatnym Langfuse oraz adresem URL. Uzupełnij brakujące wartości, takie jak OPENAI_API_KEY, jeśli planujesz testować integracje z modelami.

3. Skill skonfiguruje plik src/lib/langfuse-dev.ts z procesorem span zoptymalizowanym dla deweloperki — w trybie development eksportuje ślady co 1 sekundę z minimalnym opóźnieniem, aby natychmiast widzieć wyniki.

4. Jeśli chcesz uruchomić Langfuse lokalnie zamiast korzystać z chmury, skill może przygotować polecenie Docker do uruchomienia kontenera z bazą danych i interfejsem webowym.

5. Uruchom aplikację za pomocą tsx z hot reload: npm run dev lub npx tsx --watch src/index.ts. Każda zmiana w kodzie spowoduje przeładowanie bez konieczności ręcznego restartu.

6. Otwórz interfejs Langfuse (cloud.langfuse.com lub localhost, jeśli używasz Docker) i obserwuj ślady w czasie rzeczywistym — każde wywołanie modelu pojawi się natychmiast, co ułatwia debugowanie i optymalizację.