K K L U U BBBB EEEEE H H OOO SSSS GGG EEEEE L DDDD IIIII N N !
K K L U U B B E H H O O S G E L D D I NN N !
KKK L U U BBBB EEE HHHHH O O SSS G GG EEE L D D I N N N !
K K L U U B B E H H O O S G G E L D D I N NN
K K LLLLL UUU BBBB EEEEE H H OOO SSSS GGG EEEEE LLLLL DDDD IIIII N N !
## Kurulum
```bash
npm install
```
> [!IMPORTANT]
> Gemini 3 preview "indirilen bir program" degil, Google Cloud Vertex AI uzerinden API ile kullanilan bir model ailesidir.
## Gelistirme
## 0) Ogrenci Icin Tek Adim
1. Ollama'yi bir kez kur: https://docs.ollama.com/windows models kısmına gir https://ollama.com/library ve gemini 3 preview cloud modelinini çalıştır yetki giriş gerekecek. ollama artık lokalinde bir LLM olarak sana hizmet vermeye hazır .
2. Bu klasorde sadece `BASLAT.bat` calistir.
3. Hepsi bu kadar.
> [!IMPORTANT]
> Ogrenci tarafinda ekstra komut gerekmez. `BASLAT.bat` gerekli durumda `kurulum.bat` dosyasini otomatik cagirir ve ortami kendi kurar.
## 1) BASLAT Calisinca Ne Oluyor?
1.`BASLAT.bat` önce `.venv` var mi kontrol eder.
2. Yoksa `kurulum.bat` otomatik calisir; Python 3 kontrolu, `.venv` olusturma, `pip` guncelleme ve `requirements.txt` paket kurulumu yapilir.
3. Sonra `main.pyw` arka planda acilir.
4. Uygulama varsayilan olarak `gemma3:1b` modeliyle Ollama'ya istek atar.
Ollama API varsayilan adresi: `http://localhost:11434`
## 2) Google Cloud Gemini 3 Preview (Vertex AI)
### Once gerekli olanlar
- Google Cloud projesi
- Billing acik olmali
- Vertex AI API aktif olmali
-`gcloud` CLI kurulu olmali
### gcloud giris ve kimlik
```powershell
gcloudinit
gcloudauthapplication-defaultlogin
```bash
npm run dev
```
### Proje ve API ayari
Uygulama varsayilan olarak `http://localhost:3000` adresinde calisir.
```powershell
gcloudconfigset projectYOUR_PROJECT_ID
gcloudservicesenableaiplatform.googleapis.com
## Production Build
```bash
npm run build
npm run start
```
### Python SDK kurulumu
## MVP Kapsami
```powershell
pipinstall--upgradegoogle-genai
Dahil:
- Mood secimi
- Enerji seviyesi secimi
- LocalStorage kayit
- Line chart
- Pie chart
- Basit insight
Dahil degil:
- Kullanici girisi
- Cloud sync
- Bildirim sistemi
- Sosyal paylasim
- PDF rapor
- AI destekli yorumlama
- Dark mode
- Heatmap
## Veri Modeli
```ts
typeMoodEntry={
id: string;
date: string;
mood:"happy"|"neutral"|"sad"|"angry";
mood_score: 4|3|2|1;
energy: 1|2|3|4|5;
};
```
### Ortam degiskenleri (PowerShell)
```powershell
$env:GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
$env:GOOGLE_CLOUD_LOCATION="global"
$env:GOOGLE_GENAI_USE_VERTEXAI="True"
```
### Ilk Gemini 3 Preview istegi
```python
fromgoogleimportgenai
client=genai.Client()
response=client.models.generate_content(
model="gemini-3-flash-preview",
contents="Merhaba! Bana 3 maddede Python'da for dongusunu anlat.",
)
print(response.text)
```
## 3) Mini Ogrenci Challenge (Opsiyonel)
1. Terminalde su komutu yaz: `ollama run gemini-3-flash-preview`
2. Sonra Ollama'da gecerli bir modelle sor: `ollama run gemma3:1b`
3. Ayni soruyu Gemini 3 preview ile sor.
4. Cevaplari hiz, detay ve dogruluk acisindan karsilastir.
## 4) Hata Cozme Kisa Notlari
-`403` alirsan: Billing, Vertex AI API ve IAM rol (`roles/aiplatform.user`) kontrol et.
-`401` alirsan: `gcloud auth application-default login` komutunu yeniden calistir.
-`ollama model not found` alirsan once su komutu calistir: `ollama run gemma3:1b`
-`Model not found` alirsan: model ID'yi kontrol et (`gemini-3-flash-preview`, `gemini-3-pro-preview`, `gemini-3.1-pro-preview`).
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.