Kısa cevap: ollama.com/download adresinden işletim sisteminize uygun paketi indirip kurun (Linux'ta curl -fsSL https://ollama.com/install.sh | sh). Terminalde ollama run gemma4:e2b yazın; model iner ve sohbet başlar. Çıkmak için /bye. Ollama arka planda http://localhost:11434 adresinde OpenAI uyumlu bir API de sunar.
Bu rehber Ollama resmî belgelerine dayanır. Lokal AI'nın ne olduğunu ve ne zaman mantıklı olduğunu lokal AI nedir? yazısında anlattık.
Gereksinimler
| Bileşen | Gereksinim |
|---|---|
| macOS | Apple Silicon önerilir; Intel Mac'te CPU ile çalışır |
| Windows | Windows 10 22H2 veya üzeri; NVIDIA sürücü 551.61+ ya da AMD ROCm/Vulkan destekli sürücü |
| Linux | x86_64 veya arm64; NVIDIA için CUDA sürücüleri, AMD için ROCm v7 |
| Bellek | Yerel model için en az 8 GB kullanılabilir VRAM (Mac'te birleşik bellek) önerilir |
| Disk | Uygulama ~4 GB; modeller 2 GB ile yüzlerce GB arasında |
macOS kurulumu
ollama.com/download adresinden macOS paketini indirin, açın ve uygulamayı Applications klasörüne taşıyın. İlk açılışta menü çubuğuna bir simge yerleşir ve ollama komutu terminale eklenir. Homebrew kullananlar için:
brew install ollama
Windows kurulumu
İndirilen OllamaSetup.exe dosyasını çalıştırın. Yönetici yetkisi gerekmez; varsayılan olarak kullanıcı dizinine kurulur ve PATH'e eklenir. Farklı konuma kurmak için:
OllamaSetup.exe /DIR="D:\Programlar\Ollama"
Kurulumdan sonra Ollama sistem tepsisinde arka planda çalışır; cmd, PowerShell ya da Windows Terminal'de ollama komutu kullanılabilir. Günlükler %LOCALAPPDATA%\Ollama klasöründedir.
Linux kurulumu
curl -fsSL https://ollama.com/install.sh | sh
Betik, Ollama'yı kurar ve systemd servisi olarak kaydeder. Elle kontrol için:
systemctl status ollama
journalctl -e -u ollama
NVIDIA kartta nvidia-smi çıktısı sürücünün hazır olduğunu gösterir; AMD için ROCm v7 sürücüsü gerekir. Servis çalışmıyorsa ollama serve ile elle başlatabilirsiniz. Belirli bir sürüm kurmak için OLLAMA_VERSION=0.5.7 gibi bir değişkenle betiği çalıştırın.
İlk model
ollama run gemma4:e2b
Resmî hızlı başlangıcın önerdiği model budur; yaklaşık 7,2 GB iner. İndirme bitince komut istemi değişir, soru yazabilirsiniz. Çıkmak için /bye. Yalnızca indirmek, çalıştırmamak için ollama pull gemma4:e2b.
Hangi modelin donanımınıza uygun olduğunu lokal model seçimi yazısında tabloyla verdik; kısa kural: model dosyası, kullanılabilir VRAM'inizden küçük olmalı.
Temel komutlar
| Komut | Açıklama |
|---|---|
ollama run <model> | Modeli indirir (yoksa) ve sohbet başlatır |
ollama pull <model> | Yalnızca indirir veya günceller |
ollama list | İndirilen modelleri listeler |
ollama ps | Bellekte yüklü modelleri gösterir |
ollama rm <model> | Modeli siler |
ollama show <model> | Model bilgisi: parametre, bağlam uzunluğu, lisans |
ollama serve | Sunucuyu elle başlatır (Linux'ta servis yoksa) |
Tek seferlik soru için metni komuta ekleyebilirsiniz: ollama run gemma4:e2b "Bu G-code satırı ne yapıyor: G28".
Yerel API
Ollama çalışırken http://localhost:11434 adresinde bir API sunar. OpenAI uyumlu uç nokta sayesinde OpenAI SDK kullanan her uygulama, yalnızca adres değiştirerek lokal modele bağlanır:
curl http://localhost:11434/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "gemma4:e2b",
"messages": [{"role": "user", "content": "Merhaba, kendini tanıt."}]
}'
Anthropic uyumlu uç nokta da vardır. Bu sayede Open WebUI gibi arayüzler, IDE eklentileri ve kendi Laravel ya da Python uygulamanız aynı adresi kullanır. Ağdaki başka cihazlardan erişim için OLLAMA_HOST=0.0.0.0 ayarlanır; bunu yalnızca güvendiğiniz yerel ağda yapın.
Model dizini ve ayarlar
- Model konumu: macOS/Linux'ta
~/.ollama, Windows'ta%HOMEPATH%\.ollama. Başka diske taşımak içinOLLAMA_MODELSortam değişkenini ayarlayın; Windows'ta tepsi uygulamasını kapatıp yeniden açın. - Linux servis ayarı:
sudo systemctl edit ollamaileEnvironment="OLLAMA_MODELS=/veri/ollama"gibi satırlar eklenir. - Güncelleme: macOS ve Windows uygulaması kendini günceller; Linux'ta kurulum betiğini yeniden çalıştırın.
- Kaldırma: Windows'ta Uygulamalar ve özellikler; Linux'ta servisi durdurup
/usr/local/bin/ollamave/usr/share/ollamasilinir (modeller de gider).
Grafik arayüz tercih ediyorsanız LM Studio kurulumu, ChatGPT benzeri web arayüzü için Open WebUI yazılarına geçebilirsiniz.
Sık Sorulan Sorular
Ollama ücretsiz mi?
Evet. Ollama açık kaynaklıdır ve ücretsizdir; lokal modeller de ücretsiz indirilir. Yalnızca isteğe bağlı bulut modelleri için hesap ve API anahtarı gerekir.
Ollama Windows'ta çalışır mı?
Evet. Windows 10 22H2 ve üzeri için yerel uygulama vardır; NVIDIA (sürücü 551.61+) ve AMD Radeon ekran kartlarını destekler, yönetici yetkisi gerektirmez.
Hangi modelle başlamalıyım?
Ollama resmî hızlı başlangıcı gemma4:e2b modelini önerir (yaklaşık 7,2 GB). 8 GB VRAM ya da 16 GB birleşik bellekli Mac için uygun bir başlangıçtır.
Modeller nereye iner, konumu değiştirebilir miyim?
macOS ve Linux'ta ~/.ollama, Windows'ta %HOMEPATH%\.ollama klasörüne iner. OLLAMA_MODELS ortam değişkeniyle başka diske taşıyabilirsiniz.
Ollama'yı başka uygulamalardan nasıl kullanırım?
Ollama http://localhost:11434 adresinde OpenAI uyumlu bir API sunar. OpenAI SDK'sında base URL'i bu adrese çevirmeniz yeterlidir; Open WebUI gibi arayüzler de doğrudan bağlanır.