Gemini AI Chatbot (PHP)

A secure, self-hosted AI chatbot powered by Google's Gemini API. Built with PHP, vanilla JavaScript, and CSS — no frameworks required. Features real-time typing effects, markdown rendering, code syntax highlighting, file uploads, dark/light theme, and multi-layer security.

Demo: https://ai.arvasin.com.tr/

Türkçe

Özellikler

• Çok katmanlı güvenlik: CSRF token, Origin/Referer kontrolü, IP bazlı rate limiting
• Koyu/Açık tema desteği
• Yazma efekti ile gerçekçi bot yanıtları
• Markdown desteği: Başlıklar, listeler, tablolar, kod blokları
• Kod sözdizimi vurgulaması (Highlight.js)
• Dosya yükleme: Resim, PDF, TXT, CSV
• XSS koruması (DOMPurify)
• Mobil uyumlu (responsive) tasarım
• Hafif: Hiçbir framework gerektirmez

Kurulum

1. Dosyaları sunucunuza yükleyin (PHP 7.4+ gerekli, curl eklentisi aktif olmalı)

1. config.php (Satır 10) dosyasını düzenleyin — API anahtarınızı girin:

   define('GEMINI_API_KEY', 'BURAYA_API_ANAHTARINIZI_GİRİN');
   

   API anahtarınızı Google AI Studio adresinden alabilirsiniz.

1. api.php dosyasını düzenleyin:
   • (Satır 15) $YOUR_DOMAIN değişkenini kendi domain adınızla değiştirin:

     $YOUR_DOMAIN = 'sizindomain.com';
     

   • (Satır 172) systemInstruction bölümündeki sistem komutunu özelleştirin:

     $data['systemInstruction'] = [
         'parts' => [
             ['text' => "Kendi özel komutunuzu buraya yazın."]
         ]
     ];
     

   • (Satır 198) $GEMINI_MODEL değişkenini istediğiniz modelle değiştirin:

     $GEMINI_MODEL = 'gemini-3.1-flash-lite-preview';
     

1. index.php (Satır 5) dosyasını düzenleyin:
   • $YOUR_DOMAIN değişkenini kendi domain adınızla değiştirin:

     $YOUR_DOMAIN = 'sizindomain.com';
     

   • Sayfa başlığını, karşılama metnini ve placeholder'ı isteğinize göre değiştirin.

1. .htaccess (Satır 58 ve 67) dosyasını düzenleyin:
   • İlgili satırlardaki yourdomain\.com kısımlarını kendi domain adınızla değiştirin (noktaları \. şeklinde escape etmeyi unutmayın):

     RewriteCond %{HTTP_REFERER} !^https?://(www\.)?sizindomain\.com [NC]
     

1. Görselleri değiştirin (isteğe bağlı):
   • logo.png — Bot avatarı ve favicon
   • kullanici.png — Kullanıcı avatarı

Dosya Yapısı

English

Features

• Multi-layer security: CSRF token, Origin/Referer check, IP-based rate limiting
• Dark/Light theme toggle
• Typing effect for realistic bot responses
• Markdown support: Headings, lists, tables, code blocks
• Code syntax highlighting (Highlight.js)
• File upload: Images, PDF, TXT, CSV
• XSS protection (DOMPurify)
• Mobile-friendly (responsive) design
• Lightweight: No frameworks required

Setup

1. Upload files to your server (PHP 7.4+ required, curl extension must be enabled)

1. Edit config.php (Line 10) — Enter your API key:

   define('GEMINI_API_KEY', 'YOUR_GEMINI_API_KEY_HERE');
   

   Get your API key from Google AI Studio.

1. Edit api.php:
   • (Line 15) Replace $YOUR_DOMAIN with your actual domain:

     $YOUR_DOMAIN = 'yourdomain.com';
     

   • (Line 172) Customize the system instruction to define your AI's personality:

     $data['systemInstruction'] = [
         'parts' => [
             ['text' => "Your custom system prompt goes here."]
         ]
     ];
     

   • (Line 198) Set your preferred Gemini model:

     $GEMINI_MODEL = 'gemini-3.1-flash-lite-preview';
     

1. Edit index.php (Line 5):
   • Replace $YOUR_DOMAIN with your actual domain:

     $YOUR_DOMAIN = 'yourdomain.com';
     

   • Customize the page title, greeting text, and placeholder as needed.

1. Edit .htaccess (Lines 58 and 67):
   • Replace yourdomain\.com with your actual domain (escape dots with \.):

     RewriteCond %{HTTP_REFERER} !^https?://(www\.)?yourdomain\.com [NC]
     

1. Replace images (optional):
   • logo.png — Bot avatar and favicon
   • kullanici.png — User avatar

File Structure

Security Architecture

User Request
    │
    ├── .htaccess ──── HTTPS redirect, referer check, sensitive file blocking
    │
    ├── api.php
    │   ├── Origin check (CORS)
    │   ├── CSRF token validation
    │   ├── Referer check (2nd layer)
    │   ├── Rate limiting (30 req/hour per IP)
    │   ├── POST-only enforcement
    │   ├── JSON validation
    │   └── Response filtering (text-only output)
    │
    └── config.php ──── API key (blocked from external access)

Available Gemini Models

See the full list at Google AI Models.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Original Author: Ahmet Emin Kahraman

Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.