README.md

metadata

title: Crypto Agent
emoji: 🚀
colorFrom: blue
colorTo: red
sdk: gradio
sdk_version: 5.1.0
app_file: app.py
pinned: false

🚀 Crypto-Agent

Yapay Zeka Destekli Otonom Kripto Analiz ve Alım-Satım Simülatörü

Crypto-Agent, yerleşik yapay zeka entegrasyonu sayesinde kripto para piyasasını gerçek zamanlı analiz eden ve kullanıcıların sanal cüzdanlarıyla anlık fiyatlar üzerinden işlem (alım-satım) yapmasına olanak tanıyan otonom bir akıllı asistandır.

Hızlı Linkler: Özellikler · Nasıl Çalışır? · Kurulum · Teknoloji Yığını

---

❓ Crypto-Agent Nedir?

Crypto-Agent, açık kaynaklı bir dil modelinin (Qwen 2.5 7B Instruct) dış API'ler ile doğrudan iletişim kurarak işlem yapabilmesini (Tool-Calling) sağlayan gelişmiş bir sanal portföy yönetim sistemidir. Sistem yapay zekanın halüsinasyon (olmayan veriyi uydurma) sorunlarını engellemek adına doğrudan Binance.US üzerinden canlı fiyat verileri alır ve işlemleri anında yerel bir SQLite veritabanına yansıtır.

✨ Özellikler

Özellik	Açıklama
🤖 Otonom Araç Kullanımı (Tool Calling)	Yapay zeka kullanıcının isteğini analiz edip hangi fonksiyonu çağıracağına kendi karar verir (Fiyat çekme, Portföy görüntüleme, Alım-Satım).
📊 Gerçek Zamanlı Fiyatlandırma	Binance.US API entegrasyonu sayesinde her zaman anlık ve gerçeğe uygun fiyatlar üzerinden işlem yapılır.
💼 Sanal Cüzdan & Veritabanı	SQLite tabanlı veritabanı ile kullanıcının sanal cüzdanı ve geçmişi güvenle tutulur (Başlangıç bakiyesi 10.000$).
⚡ Matematik Hatalarını Önleme	Dil modellerinin (LLM) matematiksel hatalar yapmasını önlemek için "Dolarlık alım" işlemleri doğrudan arka uçta (Python ile) kusursuz hesaplanır.
🎨 Temiz & Minimal Arayüz	Kullanıcı deneyimi odaklı, göz yormayan, son derece sade ve anlaşılır bir Gradio Chat arayüzü sunar.

🧠 Nasıl Çalışır?

Sistem, kullanıcının girdiği metni alır, yapılandırılmış sistem kurallarına göre analiz eder ve otonom bir eyleme dönüştürür.

• Girdi (Input): Kullanıcı işlemi belirtir (Örn: "1000 dolarlık BTC al").
• Analiz (Analysis): Model cümleyi yorumlar ve execute_trade aracını kullanması gerektiğini anlar.
• Veri Çekme (Data Retrieval): Model, işlemi onaylamadan önce arka planda Binance'ten anlık BTC fiyatını çeker.
• Yürütme (Execution): Kripto miktarı arka planda hatasız hesaplanarak sanal veritabanına işlenir.
• Sentez (Synthesis): Model işlemi tamamladığına dair formatlı ve kullanıcı dostu bir özet yanıt oluşturarak kullanıcıya döner.

🛠️ Kurulum

Projeyi yerel makinenizde çalıştırmak için aşağıdaki adımları izleyebilirsiniz.

1. Depoyu Klonlayın

git clone https://github.com/MertAlii/Crypto-Agent.git
cd Crypto-Agent

2. Gerekli Kütüphaneleri Yükleyin

⚠️ Not: Uygulamanın içerisinde Hugging Face platformuna özel spaces modülü kullanılmaktadır. Projeyi yerelde (kendi bilgisayarınızda) çalıştırırken ilgili spaces import satırlarını veya @spaces.GPU dekoratörlerini yorum satırına almanız gerekebilir.

pip install -r requirements.txt

3. Uygulamayı Başlatın

python app.py

Arayüz genellikle http://127.0.0.1:7860/ adresinde yerel olarak yayınlanacaktır.

🏗️ Teknoloji Yığını

Katman	Teknoloji	Görev
Kullanıcı Arayüzü (UI)	Gradio (v5)	Sade ve minimal Chatbot arayüzü
Dil Modeli (LLM)	Qwen 2.5 7B Instruct	Dili anlama ve otonom araç (tool) seçimi
Veri Sağlayıcı	Python requests	Binance.US API'si ile anlık fiyat okuma
Veritabanı	SQLite3	Kullanıcı varlıkları ve portföy durumunun kalıcı olarak saklanması
Sunucu Ortamı	Hugging Face Spaces	Uygulamanın bulutta canlı olarak (ZeroGPU ile) barındırılması

---

Mert Ali tarafından ❤️ ile geliştirildi.