needle-tr 0.1.0__tar.gz

needle_tr-0.1.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.3
+Name: needle-tr
+Version: 0.1.0
+Summary: Türkçe Araç Çağırıcı ve Fine-Tuning Sistemi
+Author: emrekayik
+Author-email: emrekayik <emrekayik1905@gmail.com>
+Requires-Dist: cactus-needle>=3.0.5
+Requires-Dist: datasets>=5.0.1
+Requires-Dist: peft>=0.21.0
+Requires-Dist: torch>=2.14.0
+Requires-Dist: transformers>=5.17.0
+Requires-Dist: trl>=1.14.0
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# needle-tr
+
+Türkçe Araç Çağırıcı (Tool Calling) ve Fine-Tuning Sistemi.
+
+`needle-tr`, Türkçe dilinde fonksiyon / araç çağırma (function calling) yeteneklerine sahip yapay zeka modelleri geliştirmek, sentetik veri üretmek, LoRA ile fine-tuning yapmak ve Ollama üzerinde dağıtmak için tasarlanmış uçtan uca bir kütüphane ve CLI aracıdır.
+
+Proje, [Cactus Compute](https://github.com/cactus-compute/needle) tarafından geliştirilen hafif ve cihaz üstü (on-device) araç çağırma modeli **[Needle](https://github.com/cactus-compute/needle)** (`cactus-needle`) altyapısını temel alarak Türkçe dil desteği ve fine-tuning araçlarıyla genişletilmiştir.
+
+---
+
+## 🚀 Özellikler
+
+- **Yerleşik Türkçe Araçlar:** Hava durumu sorgulama, mesaj gönderme, alarm kurma, matematiksel hesaplama gibi şablon araçlar.
+- **Sentetik Veri Üretici:** Tohum (seed) veriler ve isteğe bağlı yerel Ollama (`qwen2.5:7b` vb.) desteğiyle Türkçe veri seti genişletme (`data/train.jsonl`, `data/val.jsonl`).
+- **LoRA Fine-Tuning Desteği:** Hugging Face `transformers`, `peft` ve `trl` entegrasyonu ile hedef modelleri Türkçe araç çağırma formatına uyarlama.
+- **Ollama Dağıtımı:** Eğitilen veya mevcut modeller için otomatik `Modelfile` üretimi ve tek tıkla Ollama ortamına aktarım.
+
+---
+
+## 📦 Kurulum
+
+Bu proje [uv](https://github.com/astral-sh/uv) paket yöneticisi ile yönetilmektedir:
+
+```bash
+# Bağımlılıkları senkronize edin
+uv sync
+```
+
+---
+
+## 🛠️ CLI Kullanımı
+
+Tüm süreç `needle-tr` komut satırı arayüzü ile yönetilebilir:
+
+### 1. Sentetik Veri Üretimi
+
+```bash
+# Yerel tohum verileri kullanarak
+uv run needle-tr generate-data
+
+# Ollama ile zenginleştirilmiş veri üretimi
+uv run needle-tr generate-data --use-ollama --ollama-model qwen2.5:7b
+```
+
+### 2. Fine-Tuning
+
+```bash
+# Doğrulama (Dry-run)
+uv run needle-tr train --dry-run
+
+# Eğitim başlatma
+uv run needle-tr train --base-model Qwen/Qwen2.5-7B-Instruct --epochs 3
+```
+
+### 3. Ollama Modelfile Dışa Aktarma
+
+```bash
+uv run needle-tr export-ollama --base-model qwen2.5:7b --model-name needle-tr
+```
+
+Ardından Ollama üzerinde modeli oluşturun ve çalıştırın:
+
+```bash
+ollama create needle-tr -f Modelfile
+ollama run needle-tr "25 * 4 hesapla"
+```
+
+---
+
+## 🐍 Python Ajan Kullanımı
+
+Cihaz üstü yerel ajan çalıştırma, [Cactus Compute Needle](https://github.com/cactus-compute/needle) (`cactus-needle`) kütüphanesini kullanır:
+
+```bash
+uv run needle-agent
+```
+
+Veya Python kodunuz içerisinde:
+
+```python
+from needle_tr import agent
+
+response = agent.run("İstanbul'da hava durumu nasıl?")
+print(response)
+```
+
+---
+
+## 📚 Detaylı Rehber
+
+Ayrıntılı adımlar ve mimari açıklamaları için [FINETUNE_GUIDE.md](FINETUNE_GUIDE.md) dosyasına göz atabilirsiniz.
+
+---
+
+## 📊 Benchmark ve Başarım Sonuçları
+
+`needle-tr` yerleşik benchmark aracı ile ölçülen son başarım sonuçları:
+
+![Needle-TR Benchmark Sonuçları](benchmark_results.svg)
+
+### 📈 Özet Performans Metrikleri
+
+| Metrik | Değer | Açıklama |
+| :--- | :--- | :--- |
+| **Test Edilen Hedef** | `Cactus Needle (On-Device Agent)` | Test edilen ortam (Ajan / Model) |
+| **Toplam Test Sayısı** | **14** | Doğrulama sorgusu sayısı |
+| **Araç Seçim Doğruluğu** | **%92.9** (13/14) | Doğru fonksiyonun seçilme oranı |
+| **Argüman Doğruluğu** | **%78.6** (11/14) | Parametrelerin eksiksiz eşleşme oranı |
+| **Geçerli Yanıt / JSON** | **%100.0** (14/14) | Bozulma olmadan parse edilen çağrılar |
+| **Ortalama Gecikme** | **261.2 ms** | Min: 59.1 ms, Max: 931.0 ms |
+| **Son Güncelleme** | `2026-09-28 15:13:49` | Otomatik benchmark çalıştırma zamanı |
+
+### 🔍 Araç Bazında Detay Dağılımı
+
+| Araç (Tool) | Araç Doğruluğu | Argüman Eşleşmesi | Test Sayısı | Ortalama Gecikme |
+| :--- | :---: | :---: | :---: | :---: |
+| `calculate` | %100.0 | %50.0 | 4 | 75.3 ms |
+| `get_weather` | %75.0 | %75.0 | 4 | 556.5 ms |
+| `send_message` | %100.0 | %100.0 | 3 | 214.8 ms |
+| `set_alarm` | %100.0 | %100.0 | 3 | 161.6 ms |
+
+Benchmark testlerini kendiniz çalıştırmak ve grafiği güncellemek için:
+
+```bash
+# Cactus Needle (On-device) Ajanı için
+uv run needle-tr benchmark --target agent
+
+# Ollama Modeli için
+uv run needle-tr benchmark --target ollama --ollama-model needle-tr
+```
+
+## 🙏 Referanslar & Teşekkürler
+
+- **[Cactus Compute - Needle](https://github.com/cactus-compute/needle):** Cihaz üzerinde (on-device) çalışan hafif ve verimli fonksiyon / araç çağırma kütüphanesi (`needle`).

needle_tr-0.1.0/README.md

@@ -0,0 +1,134 @@
+# needle-tr
+
+Türkçe Araç Çağırıcı (Tool Calling) ve Fine-Tuning Sistemi.
+
+`needle-tr`, Türkçe dilinde fonksiyon / araç çağırma (function calling) yeteneklerine sahip yapay zeka modelleri geliştirmek, sentetik veri üretmek, LoRA ile fine-tuning yapmak ve Ollama üzerinde dağıtmak için tasarlanmış uçtan uca bir kütüphane ve CLI aracıdır.
+
+Proje, [Cactus Compute](https://github.com/cactus-compute/needle) tarafından geliştirilen hafif ve cihaz üstü (on-device) araç çağırma modeli **[Needle](https://github.com/cactus-compute/needle)** (`cactus-needle`) altyapısını temel alarak Türkçe dil desteği ve fine-tuning araçlarıyla genişletilmiştir.
+
+---
+
+## 🚀 Özellikler
+
+- **Yerleşik Türkçe Araçlar:** Hava durumu sorgulama, mesaj gönderme, alarm kurma, matematiksel hesaplama gibi şablon araçlar.
+- **Sentetik Veri Üretici:** Tohum (seed) veriler ve isteğe bağlı yerel Ollama (`qwen2.5:7b` vb.) desteğiyle Türkçe veri seti genişletme (`data/train.jsonl`, `data/val.jsonl`).
+- **LoRA Fine-Tuning Desteği:** Hugging Face `transformers`, `peft` ve `trl` entegrasyonu ile hedef modelleri Türkçe araç çağırma formatına uyarlama.
+- **Ollama Dağıtımı:** Eğitilen veya mevcut modeller için otomatik `Modelfile` üretimi ve tek tıkla Ollama ortamına aktarım.
+
+---
+
+## 📦 Kurulum
+
+Bu proje [uv](https://github.com/astral-sh/uv) paket yöneticisi ile yönetilmektedir:
+
+```bash
+# Bağımlılıkları senkronize edin
+uv sync
+```
+
+---
+
+## 🛠️ CLI Kullanımı
+
+Tüm süreç `needle-tr` komut satırı arayüzü ile yönetilebilir:
+
+### 1. Sentetik Veri Üretimi
+
+```bash
+# Yerel tohum verileri kullanarak
+uv run needle-tr generate-data
+
+# Ollama ile zenginleştirilmiş veri üretimi
+uv run needle-tr generate-data --use-ollama --ollama-model qwen2.5:7b
+```
+
+### 2. Fine-Tuning
+
+```bash
+# Doğrulama (Dry-run)
+uv run needle-tr train --dry-run
+
+# Eğitim başlatma
+uv run needle-tr train --base-model Qwen/Qwen2.5-7B-Instruct --epochs 3
+```
+
+### 3. Ollama Modelfile Dışa Aktarma
+
+```bash
+uv run needle-tr export-ollama --base-model qwen2.5:7b --model-name needle-tr
+```
+
+Ardından Ollama üzerinde modeli oluşturun ve çalıştırın:
+
+```bash
+ollama create needle-tr -f Modelfile
+ollama run needle-tr "25 * 4 hesapla"
+```
+
+---
+
+## 🐍 Python Ajan Kullanımı
+
+Cihaz üstü yerel ajan çalıştırma, [Cactus Compute Needle](https://github.com/cactus-compute/needle) (`cactus-needle`) kütüphanesini kullanır:
+
+```bash
+uv run needle-agent
+```
+
+Veya Python kodunuz içerisinde:
+
+```python
+from needle_tr import agent
+
+response = agent.run("İstanbul'da hava durumu nasıl?")
+print(response)
+```
+
+---
+
+## 📚 Detaylı Rehber
+
+Ayrıntılı adımlar ve mimari açıklamaları için [FINETUNE_GUIDE.md](FINETUNE_GUIDE.md) dosyasına göz atabilirsiniz.
+
+---
+
+## 📊 Benchmark ve Başarım Sonuçları
+
+`needle-tr` yerleşik benchmark aracı ile ölçülen son başarım sonuçları:
+
+![Needle-TR Benchmark Sonuçları](benchmark_results.svg)
+
+### 📈 Özet Performans Metrikleri
+
+| Metrik | Değer | Açıklama |
+| :--- | :--- | :--- |
+| **Test Edilen Hedef** | `Cactus Needle (On-Device Agent)` | Test edilen ortam (Ajan / Model) |
+| **Toplam Test Sayısı** | **14** | Doğrulama sorgusu sayısı |
+| **Araç Seçim Doğruluğu** | **%92.9** (13/14) | Doğru fonksiyonun seçilme oranı |
+| **Argüman Doğruluğu** | **%78.6** (11/14) | Parametrelerin eksiksiz eşleşme oranı |
+| **Geçerli Yanıt / JSON** | **%100.0** (14/14) | Bozulma olmadan parse edilen çağrılar |
+| **Ortalama Gecikme** | **261.2 ms** | Min: 59.1 ms, Max: 931.0 ms |
+| **Son Güncelleme** | `2026-09-28 15:13:49` | Otomatik benchmark çalıştırma zamanı |
+
+### 🔍 Araç Bazında Detay Dağılımı
+
+| Araç (Tool) | Araç Doğruluğu | Argüman Eşleşmesi | Test Sayısı | Ortalama Gecikme |
+| :--- | :---: | :---: | :---: | :---: |
+| `calculate` | %100.0 | %50.0 | 4 | 75.3 ms |
+| `get_weather` | %75.0 | %75.0 | 4 | 556.5 ms |
+| `send_message` | %100.0 | %100.0 | 3 | 214.8 ms |
+| `set_alarm` | %100.0 | %100.0 | 3 | 161.6 ms |
+
+Benchmark testlerini kendiniz çalıştırmak ve grafiği güncellemek için:
+
+```bash
+# Cactus Needle (On-device) Ajanı için
+uv run needle-tr benchmark --target agent
+
+# Ollama Modeli için
+uv run needle-tr benchmark --target ollama --ollama-model needle-tr
+```
+
+## 🙏 Referanslar & Teşekkürler
+
+- **[Cactus Compute - Needle](https://github.com/cactus-compute/needle):** Cihaz üzerinde (on-device) çalışan hafif ve verimli fonksiyon / araç çağırma kütüphanesi (`needle`).

needle_tr-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "needle-tr"
+version = "0.1.0"
+description = "Türkçe Araç Çağırıcı ve Fine-Tuning Sistemi"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "cactus-needle>=3.0.5",
+    "datasets>=5.0.1",
+    "peft>=0.21.0",
+    "torch>=2.14.0",
+    "transformers>=5.17.0",
+    "trl>=1.14.0",
+]
+
+[[project.authors]]
+name = "emrekayik"
+email = "emrekayik1905@gmail.com"
+
+[project.scripts]
+needle-tr = "needle_tr.cli:main"
+needle-agent = "needle_tr:main"
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13.0"]
+build-backend = "uv_build"

needle_tr-0.1.0/pyproject.toml.orig

@@ -0,0 +1,26 @@
+[project]
+name = "needle-tr"
+version = "0.1.0"
+description = "Türkçe Araç Çağırıcı ve Fine-Tuning Sistemi"
+readme = "README.md"
+authors = [
+    { name = "emrekayik", email = "emrekayik1905@gmail.com" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "cactus-needle>=3.0.5",
+    "datasets>=5.0.1",
+    "peft>=0.21.0",
+    "torch>=2.14.0",
+    "transformers>=5.17.0",
+    "trl>=1.14.0",
+]
+
+[project.scripts]
+needle-tr = "needle_tr.cli:main"
+needle-agent = "needle_tr:main"
+
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13.0"]
+build-backend = "uv_build"

needle_tr-0.1.0/src/needle_tr/__init__.py

@@ -0,0 +1,21 @@
+import needle
+
+
+from .tools import ACTIVE_TOOLS, calculate, get_weather, send_message, set_alarm
+
+agent = needle.Needle(
+    tools=ACTIVE_TOOLS,
+    stateless=True,
+)
+
+
+def main():
+    print("Hava durumu:", agent.run("Lagos'ta hava nasıl?")["results"])
+    print("Mesaj gönderme:", agent.run("Ahmet'e 'Toplantı başladı' mesajı gönder")["results"])
+    print("Alarm kurma:", agent.run("Saat 07:30'a alarm kur")["results"])
+    print("Hesaplama:", agent.run("25 * 4 hesapla")["results"])
+
+
+if __name__ == "__main__":
+    main()
+