🩺 AI Doktor Asistanı / AI Doctor Assistant
🟢 Canlı uygulama / Live app · 👩💻 Portfolyo / Portfolio
🇹🇷 Türkçe
Proje Hakkında
Kullanıcının adını, yaşını ve sağlık şikayetini alarak kişiselleştirilmiş Türkçe sağlık bilgisi sunan, hafızalı bir AI doktor asistanı. OpenRouter üzerinden çalışan Google Gemini modeli, LangChain ile yönetilen konuşma hafızası ve FastAPI tabanlı bir servis ile geliştirilmiştir.
⚠️ Bu uygulama tıbbi teşhis koymaz. Sağlık sorunlarınız için mutlaka bir doktora danışınız.
Özellikler
- 🧠 Konuşma hafızası — oturum boyunca önceki mesajları hatırlar
- 👤 Kişiselleştirme — kullanıcıya ismiyle hitap eder, yaşa uygun yanıt üretir
- 🚨 Acil durum algısı — kritik semptomlarda doğrudan acil uyarısı verir, başka öneri eklemez
- 🌐 Web arayüzü — giriş formu (ad, yaş, şikayet) + sohbet ekranı
- 🔒 Oturum yönetimi — oturumu kapat ve yeni kullanıcı başlat
Ekran görüntüleri
Soldan sağa: giriş formu · kişiye özel yanıt · acil belirtide tek cümlelik yönlendirme
Mimari
Birbirine bağımlı olmayan iki servis. SSL'i sunucudaki ters vekil bitirir.
| Parça | Yol | Alan adı | Host portu |
|---|
| Backend — FastAPI + LangChain | backend/ | doctor-assistant-api.aisli.dev | 8003 |
| Frontend — React + Vite + nginx | frontend/ | doctor-assistant.aisli.dev | 8002 |
Frontend nginx'i yalnız statik dosya servis eder, backend'e bağlanmaz. Tarayıcı API'ye VITE_API_BASE adresinden doğrudan gider; bu adres derlemeye gömülür, değişirse imaj yeniden derlenmelidir. Backend de FRONTEND_URL ile yalnız frontend'in origin'ine CORS izni verir.
ai-doctor/
├── backend/
│ ├── llm.py # model, prompt, zincir, hafıza
│ ├── api.py # FastAPI (yalnız JSON)
│ ├── terminal.py # terminal sürümü
│ ├── tests/ # birim testleri (pytest, sahte model)
│ ├── smoke_test.py # davranış doğrulaması
│ ├── Dockerfile · docker-compose.yml · Makefile
│ └── .env.example
└── frontend/
├── src/ # React + TypeScript
├── Dockerfile · nginx.conf · docker-compose.yml · Makefile
└── .env.example
Kurulum
Backend
cd backend
cp .env.example .env # OPENROUTER_API_KEY değerini doldurun
make up # derle ve başlat
make health # {"status":"ok", ...}
Frontend
cd frontend
VITE_API_BASE=http://localhost:8003 make up # yerel backend'e bağlan
Tarayıcıda http://localhost:8002 adresini açın.
Yerel geliştirme
Docker olmadan, iki terminalde:
cd backend && make dev # uvicorn :8000, canlı yeniden yükleme
cd frontend && make dev # vite :5173, /chat isteklerini :8000'e proxy'ler (yalnız dev)
Terminal sürümü için: cd backend && make terminal
Doğrulama
cd backend && pytest # birim testleri (API anahtarı ve ağ gerekmez)
cd backend && make test # gerçek API'ye karşı davranış testi
cd frontend && make typecheck # TypeScript denetimi
pytest modeli sahte bir modelle değiştirir; HTTP katmanını (doğrulama, 503 hata yönetimi), oturum hafızasını ve sistem promptundaki güvenlik kurallarını kontrol eder ve her push'ta GitHub Actions'ta çalışır.
make test OpenRouter'a gerçek istek atar ve kredi harcar. Kontrol ettikleri:
- isimle hitap, turlar arası hafıza, acil durum yanıtının tek cümle kalması
- teşhis konmadan belirtilerden hastalık adı çıkarılmaması
- söylenmiş bilginin (süre, teşhis) tekrar sorulmaması, önceki önerilerin yeniden listelenmemesi
- ıhlamur, sıvı, dinlenme gibi zararsız önerilerin reddedilmeden verilmesi
- "uzmana danışın" ve selamlama kalıplarının her yanıtta tekrarlanmaması
- markdown kullanılmaması (arayüz düz metin gösterir)
- ilaç adı ve doz önerilmemesi
Model çıktısı deterministik olmadığından tek bir başarısızlık gürültü olabilir; tekrarlıyorsa gerçek bir gerilemedir.
Model
Varsayılan google/gemini-2.5-flash (~0.30$/1M token). OpenRouter'da ücretsiz Gemini kalmadı; daha ucuzu google/gemini-2.5-flash-lite (~0.10$) ama yönergeleri daha zayıf takip ediyor. Model OPENROUTER_MODEL ile değiştirilir.
max_tokens 800'e sabitlenmiştir: verilmezse OpenRouter modelin tavanını (65k) varsayıp bakiyeyi ona göre kontrol eder ve düşük bakiyede 402 döner.
Deploy (Dokploy)
Sunucu Dokploy ile yönetilir, SSL'i ters vekil bitirir. Sunucuda elle nginx ayarı yapılmaz, certbot çalıştırılmaz.
- DNS (Cloudflare):
doctor-assistant ve doctor-assistant-api için A kaydı → sunucu IP'si.
- Backend servisi: Build Type Dockerfile (Nixpacks değil), Build Path
/backend, Environment'a OPENROUTER_API_KEY ve FRONTEND_URL=https://doctor-assistant.aisli.dev. Domain doctor-assistant-api.aisli.dev, Container Port 8000.
- Frontend servisi: Build Type Dockerfile, Build Path
/frontend, Domain doctor-assistant.aisli.dev, Container Port 80.
Frontend varsayılan olarak https://doctor-assistant-api.aisli.dev adresine derlenir. Farklı bir API adresi gerekirse Build Args'a VITE_API_BASE girilip yeniden deploy edilir.
🇬🇧 English
About
A conversational AI health assistant that collects the user's name, age, and health complaint to provide personalized Turkish-language health information. Built with Google Gemini via OpenRouter, LangChain conversation memory, a FastAPI backend, and a React + Vite frontend served by nginx.
⚠️ This application does not provide medical diagnoses. Always consult a doctor for health concerns.
Screenshots
Left to right: intake form · personalised reply · one-sentence referral on an emergency symptom
Tech Stack
| Layer | Technology |
|---|
| LLM | Google Gemini (OpenRouter) |
| LLM Management | LangChain |
| Backend | FastAPI + Uvicorn |
| Frontend | React + Vite + TypeScript (bun) |
| Web server | nginx (static only) |
| Deployment | Docker + Dokploy (self-hosted) |
Quick start
cd backend && cp .env.example .env && make up
cd ../frontend && VITE_API_BASE=http://localhost:8003 make up
Open http://localhost:8002.
Run make help in either folder to see all targets.
Bilinen sınır / Known limitation
Sohbet hafızası süreç belleğinde (store sözlüğü) tutulur: konteyner yeniden başlatıldığında tüm konuşmalar silinir ve backend tek worker ile çalışmak zorundadır. Kalıcılık gerekirse bir veritabanı katmanı eklenmelidir.
Built by Aslı
