Skip to content

README.md

Latest commit

 

History

History
291 lines (187 loc) · 5.99 KB

README.md

File metadata and controls

291 lines (187 loc) · 5.99 KB

🧠 Diyalog — Yerel, Açık Kaynak Sohbet Yapay Zekâsı

Diyalog, tamamen yerel çalışan, Ollama tabanlı, açık kaynak bir sohbet yapay zekâsı projesidir. Bu proje; bulut bağımlılığı olmadan, API anahtarı gerektirmeden, kendi bilgisayarınızda veya sunucunuzda özgürce çalıştırabileceğiniz modern bir AI altyapısı sunar.

🚀 Diyalog ile Ne Yaparsın?

Diyalog ile 10–15 dakika içinde şunları kurarsın:

  • 🔒 Tamamen yerel çalışan sohbet yapay zekâ altyapısı
  • 🔑 API anahtarı yok, bulut bağımlılığı yok
  • 🧠 prompts/ ile modüler sistem prompt yönetimi (davranış / ton / sınır)
  • ⚙️ Ollama üzerinden model değiştirilebilir yapı
  • 🌐 İstersen sunucuya alıp herkese açık çalıştırabileceğin bir temel

Bu repo “demo” değil.
Kendi yapay zekâ ürününü büyütebilmen için hazırlanmış bir altyapı.

👤 Kimler İçin?

  • Local AI isteyen geliştiriciler
  • “ChatGPT gibi ama benim kontrolümde olsun” diyenler
  • Ollama’yı ürünleştirmek isteyenler
  • Prompt’ları dosya bazlı, modüler yönetmek isteyenler
  • Türkçe kaynakla hızlı başlamak isteyenler

⚡ 30 Saniyelik Senaryo

  1. Repo’yu clone’la
  2. Ollama + modeli kur
  3. prompts/ içine kendi system prompt’unu koy
  4. Uvicorn ile ayağa kaldır

Bitti: yerel çalışan sohbet yapay zekân hazır.

📚 Detaylı Dokümantasyon

Bu README, projeyi hızlıca ayağa kaldırman için yeterlidir.
Daha derin kullanım, prompt sistemi ve genişletme senaryoları için:

👉 Wiki: https://github.com/y4gizbey/diyalog/wiki

Wiki’de şunları bulursun:

  • Prompt sistemi ve system prompt mantığı
  • Model davranışlarını özelleştirme
  • Sunucuya açma ve yapılandırma notları
  • Genişletme / ürünleştirme fikirleri

🎯 Projenin Vizyonu

Bu proje özellikle Türk girişimci geliştiricilere ilham vermek amacıyla hazırlanmıştır. Amaç; herkesin kendi yapay zekâ ürününü, kendi kurallarıyla ve tam kontrolle inşa edebilmesidir.

Diyalog bir “oyuncak AI” değil;

  • geliştirilebilir
  • ölçeklenebilir
  • farklı modellere uyarlanabilir
    bir altyapı sunar.

🧩 Kullanılan Teknolojiler

  • Backend: Python + FastAPI
  • LLM Runtime: Ollama
  • Varsayılan Model: Qwen2.5
  • Frontend: Web tabanlı (HTML / CSS / JS)
  • Lisans: MIT

😎 Önizleme

image

📦 Kurulum — Yerel Makine

1️⃣ Python Kurulumu

Python 3.10+ önerilir.

python --version

Eğer yüklü değilse: 👉 https://www.python.org/downloads/

2️⃣ Sanal Ortam (Önerilir)

python -m venv .venv
source .venv/bin/activate  # Linux / macOS
.venv\Scripts\activate   # Windows

3️⃣ Gerekli Paketler

pip install fastapi uvicorn requests

🧠 Ollama Nedir?

Ollama, büyük dil modellerini (LLM) yerel olarak çalıştırmanızı sağlayan bir runtime sistemidir.

  • Bulut yok
  • API anahtarı yok
  • Tam kontrol sizde

👉 https://ollama.com

⚙️ Ollama Kurulumu

Windows / macOS / Linux

ollama --version

Yüklü değilse: 👉 https://ollama.com/download

Model Kurulumu (Varsayılan)

ollama pull qwen2.5

🖥️ Minimum Sistem Gereksinimleri (Qwen2.5)

Bileşen Minimum
CPU 6 çekirdek
RAM 16 GB
GPU Opsiyonel
VRAM 8 GB (GPU varsa önerilir)
Disk ~10 GB

💡 GPU olmadan da çalışır, ancak GPU performansı ciddi şekilde artırır.

🔁 Model Değiştirme

Diyalog model bağımsızdır.

Ancak:

  • Her model aynı backend davranışını vermez
  • Bazı modeller farklı prompt yapısı ister
  • Bazı modeller için ek optimizasyon gerekir

Model değiştirmek için:

MODEL_NAME = "qwen2.5"

Değiştirmeniz yeterlidir.

📂 Prompts Sistemi

prompts/ klasörü Diyalog’un beynidir.

Burada:

  • System promptlar
  • Davranış kuralları
  • Güvenlik politikaları
  • Psikoloji ve ton modülleri

bulunur.

Prompt Düzenleme

  • Her .prompt dosyası ayrı bir modüldür
  • Değişiklik yaptıktan sonra sunucuyu yeniden başlatın
  • Promptlar zincirleme çalışır

🧩 System Prompt Nedir?

System prompt:

  • Yapay zekânın nasıl davranacağını
  • Neye cevap verip veremeyeceğini
  • Tonunu, sınırlarını, karakterini

belirleyen ana metindir.

Diyalog’ta bu sistem modülerdir.

🌐 Herkese Açık Yapay Zekâ Yapmak

1️⃣ VDS / Sunucu Seçimi

Önerilen minimum:

Özellik Değer
CPU 8 Core
RAM 32 GB
Disk 100 GB SSD
GPU Opsiyonel (NVIDIA tercih edilir)

2️⃣ Sunucuya Kurulum

  • Ubuntu 22.04 önerilir
  • Python + Ollama kur
  • Projeyi git clone ile al
  • Uvicorn ile çalıştır
uvicorn main:app --host 0.0.0.0 --port 8000

3️⃣ Güvenlik

  • Reverse proxy (Nginx)
  • Firewall
  • Rate limit önerilir

🧑‍💻 Geliştirici

  • Kullanıcı adı: y4gizbey
  • İsim: Yağız Efe AĞCAHAN
  • Kullanıcı adı: Sefflex
  • İsim: Rahmi Çınar SARİ

Bu proje; deneye deneye, bozula bozula, gerçek bir ürün ortaya koymak isteyen herkes içindir.

📜 Lisans

MIT License
İstediğin gibi kullan, değiştir, dağıt.

Ama:

Bir şey inşa ediyorsan, arkasında dur.

⭐ Son Söz

Diyalog bir “hazır AI” değil.
Diyalog bir altyapı.

Gerisi:

  • Senin hayal gücün
  • Senin disiplinin
  • Senin cesaretin