README.md

---
title: Kripto Doviz Tool Calling Asistani
emoji: 💰
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false
---

# Kripto & Döviz Tool-Calling Asistanı

Kullanıcının doğal dille sorduğu kripto para ve döviz sorularını, **CoinGecko
API**'sini tool calling (function calling) ile kullanarak yanıtlayan bir asistan.
Model, arka planda hangi araçları çağırdığını kullanıcıya adım adım gösterir.

## Nasıl çalışır?

1. Kullanıcı soru sorar (ör. "1 Ethereum kaç TL eder?").
2. Model, soruya göre uygun **tool**'u seçer (`get_crypto_price` veya `convert_currency`).
3. Tool, CoinGecko API'sinden gerçek veriyi çeker.
4. Model, dönen veriyle Türkçe bir yanıt üretir.
5. Arka planda çağrılan tüm araçlar ve dönen veriler yanıtın altında gösterilir.

Örnek akış:

```
Kullanıcı: "Bitcoin mi daha pahalı Ethereum mi?"

[Turn 1] Araç Çağrıları:
   -> get_crypto_price(coin='bitcoin', currency='usd')
   <- {"coin": "bitcoin", "currency": "usd", "price": 65000}
   -> get_crypto_price(coin='ethereum', currency='usd')
   <- {"coin": "ethereum", "currency": "usd", "price": 3500}

[Turn 2] Nihai Yanıt:
Bitcoin (65000 USD), Ethereum'dan (3500 USD) daha pahalıdır.
```

## Araçlar (Tool / Function Definition)

| Araç | Açıklama |
|------|----------|
| `get_crypto_price(coin, currency)` | Bir kripto paranın güncel fiyatını getirir |
| `convert_currency(amount, from_currency, to_currency)` | Kripto ve fiat para birimleri arasında dönüşüm yapar |

## Kullanılan teknolojiler

- **API:** [CoinGecko](https://www.coingecko.com/en/api) (ücretsiz, anahtar gerektirmez)
- **Model:** `Qwen/Qwen2.5-72B-Instruct` (HF Inference API üzerinden)
- **Arayüz:** Gradio
- **Yayın:** Hugging Face Spaces

## Kurulum (yerel)

```bash
pip install -r requirements.txt
export HF_TOKEN="hf_..."   # HF erisim tokeni
python app.py
```

## Notlar

- HF Spaces'te `HF_TOKEN`, Space ayarlarından **Secrets** olarak eklenmelidir.
- CoinGecko ücretsiz katmanının dakikalık istek limiti vardır; yoğunlukta kısa
  süreli hata dönebilir.