bard bard-api gemini gemini-api hackgdg-25

🚀 Gemini API Örnekleri - HackGDG'25

Bu proje Ostim Teknik Üniversitesi Ostimtech GDG tarafından düzenlenen HackGDG'25 hackathonu öncesinde gerçekleştirilen bir eğitim kapsamında örnek teşkil etmesi amacıyla geliştirilmiştir.

📌 Proje Açıklaması

Gemini API kullanılarak hazırlanan bu örnek uygulama, aşağıdaki içerik üretim araçlarını sunar:

📄 CV Oluşturma
✍️ Metin Oluşturma
📰 Metin Başlığı Oluşturma
📘 README Dosyası Oluşturma

🛠️ Kullanılan Teknolojiler

✨ Öne Çıkan Özellikler

✅ CV oluşturma
✅ Metin oluşturma
✅ Başlık oluşturma
✅ README dosyası oluşturma
✅ Markdown formatında çıktı
✅ Responsive tasarım
✅ Kullanıcı dostu arayüz

📦 Kurulum Adımları

Node.JS kurulumu

Node.js JavaScript çalıştırmak için kullanılan sunucu taraflı bir platformdur. Aşağıda üç farklı işletim sistemi için kurulum adımları birlikte sunulmuştur.

📥 1. Node.js Kurulum Dosyasını İndirme

Tüm platformlar için ilk adım:

Resmi web sitesine gidin: https://nodejs.org
"LTS" (Long-Term Support) sürümünü tercih edin.
İşletim sisteminize uygun dosyayı indirin:
- Windows: .msi
- macOS: .pkg
- Linux: terminal komutları ile kurulacak (aşağıda açıklanmıştır)

⚙️ 2. Kurulum Adımları

🖥️ Windows

İndirilen .msi dosyasını çalıştırın.
Kurulum sihirbazını takip ederek Node.js ve npm'i yükleyin.
Kurulumdan sonra Başlat menüsünden "Komut İstemi" veya PowerShell'i açın:
```
node -v
npm -v
```

🍎 macOS

Seçenek 1: `.pkg` Dosyası ile

İndirilen .pkg dosyasını çalıştırın.
Kurulum adımlarını takip edin.
Terminal’i açıp aşağıdaki komutlarla kurulumu doğrulayın:
```
node -v
npm -v
```

Seçenek 2: Homebrew ile

Terminal’e şu komutları yazın:

brew update
brew install node

Doğrulama:

node -v
npm -v

🐧 Linux (Ubuntu / Debian)

Yöntem 1: NodeSource (Tavsiye Edilen)

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

Yöntem 2: Varsayılan APT (Eski sürüm olabilir)

sudo apt update
sudo apt install nodejs npm

Doğrulama (her iki yöntem sonrası):

node -v
npm -v

⚠️ Not: apt install yöntemi daha eski bir sürüm kurabilir. Güncel sürüm için NodeSource tercih edilmelidir.

✅ Kurulum Doğrulama

İşletim sistemi fark etmeksizin terminal veya komut istemcisine aşağıdaki komutları girerek kurulumun başarıyla gerçekleştiğinden emin olun:

node -v
npm -v

Bu komutlar sırasıyla Node.js ve npm sürümünüzü gösterecektir.

Önerilen versiyonlar;

node.js version 22.14.0 ve üzeri versiyonlar
npm version 10.9.2 ve üzeri versiyonlar

🔑 Gemini API Anahtarı Alma Rehberi

Google'ın yapay zeka modellerini kullanmak için Gemini API anahtarına ihtiyacınız vardır. Aşağıdaki adımları izleyerek kendi API anahtarınızı kolayca oluşturabilirsiniz.

🌐 1. Google AI Studio'ya Giriş Yapın

Tarayıcınızdan https://makersuite.google.com/app adresine gidin.
Google hesabınızla giriş yapın.

🔧 2. API Key Oluşturun

Sayfanın sağ üst kısmında bulunan profil simgesine veya menüye tıklayın.
Açılan seçenekler arasından "Get API Key", "API Anahtarı Al" veya benzeri bir seçeneği bulun ve tıklayın.
Yeni bir API anahtarı oluşturulacak ve size gösterilecektir.
Bu anahtarı kopyalayın ve güvenli bir yerde saklayın.

⚠️ Not: API anahtarınızı kimseyle paylaşmayın. Anahtarınızla yapılacak kötü amaçlı kullanımlar sizin hesabınızdan sayılır.

🚀 Proje Kurulum Adımları

🛠️ Adımlar

# 1. Projeyi klonlayın
git clone https://github.com/aliakpoyraz/gemini-api-ornekleri.git

# 2. Proje klasörüne geçin
cd gemini-api-ornegi

# 3. Gerekli kurulumları yapın
npm install

Proje dosyası içerisinde bulunan script.js ve server.js dosyalarındaki API_KEY bölümlerini kendi API anahtarınız ile değiştirin.
Aksi halde program düzgün bir şekilde çalışmayacaktır.

# 4. Sunucuyu başlatın
node server.js

🌐 Uygulamayı Görüntüleme

Tarayıcıdan aşağıdaki adrese giderek uygulamayı görüntüleyebilirsiniz:

http://localhost:3000/index.html

💡 Kullanım

Ana sayfadan istediğiniz oluşturucuyu seçin
Gerekli alanları doldurun
"Oluştur" butonuna tıklayın
Oluşturulan içeriği kopyalayın veya indirin

Şu anda okuduğunuz Readme dosyası "Gemini API Uygulamaları - HackGDG'25" Reposunda bulunan Web Uygulaması ile yazdırılmıştır.

About

Bu proje, Ostim Teknik Üniversitesi Ostimtech GDG tarafından düzenlenen HackGDG'25 hackathonu öncesinde gerçekleştirilen bir eğitim kapsamında örnek teşkil etmesi amacıyla geliştirilmiştir.