[WORKSHOP] Setting Up Your Development Environment: Python, Docker, PostgreSQL and Label Studio from Scratch

# docker-compose.yml
# Veri Etiketleme & Kalite Yönetimi — Atölye Ortamı
# Label Studio + PostgreSQL
 
services:
  postgres:
    image: postgres:16-alpine
    container_name: ve-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-labelstudio}
      POSTGRES_USER: ${POSTGRES_USER:-labelstudio}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-changeme}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-labelstudio}"]
      interval: 5s
      timeout: 5s
      retries: 5
 
  label-studio:
    image: heartexlabs/label-studio:1.13.1
    container_name: ve-label-studio
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      DJANGO_DB: default
      POSTGRE_NAME: ${POSTGRES_DB:-labelstudio}
      POSTGRE_USER: ${POSTGRES_USER:-labelstudio}
      POSTGRE_PASSWORD: ${POSTGRES_PASSWORD:-changeme}
      POSTGRE_PORT: 5432
      POSTGRE_HOST: postgres
      LABEL_STUDIO_USERNAME: ${LS_USER:-admin@local.dev}
      LABEL_STUDIO_PASSWORD: ${LS_PASSWORD:-changeme123}
      LABEL_STUDIO_DISABLE_SIGNUP_WITHOUT_LINK: "true"
      LABEL_STUDIO_HOST: http://localhost:8080
    ports:
      - "8080:8080"
    volumes:
      - ./ls_data:/label-studio/data
 
volumes:
  postgres_data:
    name: ve_postgres_data
 

[
  {"text": "Ürün vaktinde geldi, kalitesi beklediğimden çok iyi, kesinlikle tavsiye ederim."},
  {"text": "Kargo bir hafta geç geldi, ürünün ambalajı da hasarlıydı. Çok hayal kırıklığıydı."},
  {"text": "Ürün açıklamada belirtildiği gibi, ne fazla ne eksik. İdare eder."},
  {"text": "Müthiş bir alışveriş deneyimi, satıcı her sorumu hızlıca cevapladı. 5 yıldız az."},
  {"text": "Renk fotoğraftakinden çok farklı çıktı. İade etmek istiyorum."},
  {"text": "Standart bir ürün, beklenen kalite. Sürpriz yok."},
  {"text": "Beklediğimden hızlı geldi ama kutu açıkken geldi. Çelişkili duygular."},
  {"text": "Fiyatına göre fena değil, ama lüks beklemeyin. Günlük kullanım için yeterli."},
  {"text": "Hediye olarak aldım, çok beğenildi! Tekrar alacağım."},
  {"text": "Açıklamada yazan özellikler ürünle uyuşmuyor. Yanıltıcı satıcı."}
]

<View>
  <Header value="Türkçe Ürün Yorumu Sentiment Analizi"/>
 
  <Text name="yorum" value="$text"/>
 
  <Choices name="sentiment" toName="yorum" choice="single" showInLine="true">
    <Choice value="pozitif" hotkey="1" background="#22c55e"/>
    <Choice value="nötr" hotkey="2" background="#94a3b8"/>
    <Choice value="negatif" hotkey="3" background="#ef4444"/>
  </Choices>
 
  <View style="margin-top: 1em; padding: 1em; background: #f9fafb; border-radius: 8px;">
    <Header value="📋 Kılavuz"/>
    <Text name="rehber" value="• Pozitif: Müşteri memnun, tavsiye ediyor. • Nötr: Karışık/notr ifade, hayal kırıklığı yok. • Negatif: Memnuniyetsizlik, şikayet var."/>
  </View>
</View>

# Label Studio'da sağ üstten profilinize tıkla → Account & Settings → Access Token
# Token'ı kopyala, .env dosyasına ekle:
echo "LS_TOKEN=buraya-token-yapistir" >> .env
echo "LS_URL=http://localhost:8080" >> .env

# notebooks/00_ls_api_test.py
import os
from dotenv import load_dotenv
from label_studio_sdk.client import LabelStudio
 
load_dotenv()
 
ls = LabelStudio(
    base_url=os.getenv("LS_URL", "http://localhost:8080"),
    api_key=os.getenv("LS_TOKEN"),
)
 
# Tüm projeleri listele
projects = list(ls.projects.list())
print(f"Toplam proje sayısı: {len(projects)}")
 
for p in projects:
    print(f"  [{p.id}] {p.title} — {p.task_number} task")
 
# İlk projeyi seç
if projects:
    proj = projects[0]
    print(f"\n📋 Detay: {proj.title}")
    print(f"  Açıklama: {proj.description}")
    print(f"  Task sayısı: {proj.task_number}")
 
    # Etiketlenen task'ları çek
    tasks = list(ls.tasks.list(project=proj.id))
    print(f"\n📝 Etiketlenmiş task'lar:")
    for t in tasks[:5]:
        text = t.data.get("text", "")[:60]
        annotations = t.annotations
        if annotations:
            label = annotations[0]["result"][0]["value"]["choices"][0] \
                if annotations[0]["result"] else "?"
            print(f"  [{label:8s}] {text}...")