Yapılandırma

Her şey ortam değişkenleridir, açılışta doğrulanır; hatalı bir değer sessizce çalışmaya devam etmek yerine süreci durdurur. Açıklamalı ana liste .env.example kaynağındadır. openplate belgeleri, bu konteyner için her değişkeni tek sayfa üzerinde listeler. Uygulama ve eşitleme servisi değişkenlerinin yanında görünürler. En önemli değişkenler şunlardır:

Harici mod değişkenleri (MODEL_RUNTIME_URL, MODEL_ID, MODEL_RUNTIME_API_KEY), Kendi çalışma zamanını getir içinde belgelenmiştir.

llama-server, kapsayıcı içinde yalnızca 127.0.0.1 adresine bağlı şekilde çalışır ve dışarıdan erişilemez. Bu yapılandırılamaz: kimlik doğrulaması olmayan ham bir görüntü uç noktasıdır ve buradaki amaç onu yanlışlıkla yayına alamamandır.

Gıda verileri (FoodSource)

Model gıdaları tanımlar ve gramaj tahmin eder. Makrolar model tarafından asla üretilmez, bir gıda veritabanından ada göre çözümlenir.

-e FOOD_SOURCE=fdc                         # default
-e FDC_DATASET_PATH=./data/fdc-foods.json  # relative to the working directory
-e OFF_API_URL=https://world.openfoodfacts.org  # only read when FOOD_SOURCE=off
-e LCC_API_URL=https://lowcarbcheck.org    # only read when FOOD_SOURCE=lcc
-e LCC_API_KEY=lcc_live_…                   # optional; only read when FOOD_SOURCE=lcc
-e EMBEDDING_RUNTIME_URL=http://…          # optional; enables hybrid re-ranking

LCC_API_KEY olmadan FOOD_SOURCE=lcc, LowCarbCheck'in anonim katmanında çalışır: IP adresinden gelen tüm isteklerin paylaştığı, UTC günü başına 1.000 kredi. Bir arama 1 krediye mal olur. Bir tarama, en fazla 8 öğe genelinde, search-foods.ts içindeki ayrıntılandırma sınırı tarafından belirlenen, tanımlanan öğe başına en fazla 3 arama sorgusu çalıştırır. Bu da tarama başına en kötü senaryoyu 24 kredi yapar. İşlem hattı hiçbir zaman besin başına olan uç noktayı çağırmaz, bu nedenle maliyetin tamamı bu kadardır. Bu en kötü senaryo, günde yaklaşık 41 taramaya izin verir. Aramalar bir sorgu kabul eşiğini geçer geçmez durduğu için çoğu gün daha fazlasına izin verir. Katman tükendiğinde, kalan her öğe bir sonraki UTC gününe kadar boş (null) makrolara çözümlenir ve tarama yine de 200 döner. lowcarbcheck.org/developers üzerinden alınacak ücretsiz bir anahtar, kotayı dakikada 120 isteğe kadar olacak şekilde ayda 100.000 krediye çıkarır. Bu kota, IP adresin yerine doğrudan anahtara aittir. Bunu LCC_API_KEY olarak ayarla. Servis bu anahtarı LCC_API_URL adresine taşıyıcı belirteç (bearer token) olarak gönderir, başka hiçbir yere iletmez ve asla günlüğe kaydetmez. LowCarbCheck'in reddettiği bir anahtar, kotanın bitmesiyle aynı şekilde başarısız olur: boş makrolar ve 200 yanıtı. fdc ağa ve kotaya ihtiyaç duymaz.

Çözümlenen makrolar etiketlenir. Veritabanıyla eşleşen besinler "corpus" değerinde bir provenance ve kaynak gerektirdiğinde bir attribution dizesi içerir. Eşleşmeyen besinlerde iki alan da bulunmaz ve macrosPer100g null olur. openplate bu değerleri dışa aktarır, böylece kullanıcılar doğrulanmış veritabanı kayıtlarını makro verisi olmayan öğelerden ayırabilir.

Besin veritabanının eksik olması taramaları durdurmaz. FDC_DATASET_PATH hiçbir yeri göstermiyorsa, servis bir uyarı günlüğe kaydeder, çözümlemeyi devre dışı bırakır ve tabakları tanımlamayı sürdürür. Null makrolarla birlikte isimleri ve gramajları alırsın: servis bozulmaz, yalnızca performansı düşer. pnpm food-data:fdc ile özütü yeniden oluştur (ağ bağlantısı gerekir).

EMBEDDING_RUNTIME_URL isteğe bağlıdır. Bunu /v1/embeddings sunan OpenAI uyumlu ikinci bir çalışma zamanına yönlendirirsen (örneğin llama-server --embedding), geri getirme işlemi hibrit hale gelir: sözcüksel puanlayıcı adayları bulur ve yerleştirme modeli bunları yeniden sıralar, böylece veritabanında farklı ifade edilse bile "ızgara tavuk pirzola" doğru satırla eşleşir. Boş bırakırsan (varsayılan değer) geri getirme yalnızca sözcüksel olur, bu da sıralamayı biraz zayıflatır ancak asla bir hataya yol açmaz. Erişilemeyen bir yerleştirme çalışma zamanı, tek bir uyarıyla yalnızca sözcüksel moda geçer; taramayı hiçbir zaman aksatmaz.

FOOD_SOURCE=off ve ODbL ile benzeriyle paylaşım

Open Food Facts verileri benzeriyle paylaşım olan Open Database Licence (ODbL) kapsamında lisanslanmıştır. Bu bağlayıcıyı etkinleştirirsen ve ardından OFF verilerini içeren bir veritabanı yayımlar ya da yeniden dağıtırsan (görüntülediğin tekil sorgular değil, bir türetilmiş veritabanı), ODbL seni bu türetilmiş veritabanını da ODbL altında kullanıma sunmakla ve Open Food Facts'e atıfta bulunmakla yükümlü kılar.

Bir sorguyu görüntüleyen ve bunu kendi günlüğünde saklayan ev kullanımına yönelik bir kurulum için bu kural geçerli değildir. Bunun üzerine bir ürün geliştiriyorsan geçerlidir ve off seçeneğinin varsayılan olmama nedeni de budur. fdc benzeriyle paylaşım yükümlülüğü taşımaz.

Model ve veri lisansı koşulları Lisanslama içinde toplanmıştır.