# Ollama ve çevrimdışı yazım

Yerel bir model bağlayın ve ağ bağlantısı olmadan kullanabileceğiniz bir yazım iş akışı hazırlayın.

Ollama, indirilen modelleri bilgisayarınızda çalıştırır. Yerel yapay zekayı makalenizle birlikte kullanmak için onu Oleafly'ye bağlayın. Bağlantınız varken modeli ve belge bağımlılıklarını hazırlayın, sonra çevrimdışı kullanmayı düşündüğünüz iş akışını sınayın.

## Ollama'yı kurma ve başlatma

Ollama'yı [resmî indirme sayfasından](https://ollama.com/download) kurun. Ollama'yı açın ya da yerel sunucusunu bir terminalden başlatın:

```sh
ollama serve
```

Ollama zaten çalışıyorsa mevcut o sunucuyu kullanın. Bilgisayarınıza uygun bir model indirin. Örneğin:

```sh
ollama pull qwen3:8b
ollama list
```

İlk komut bir model indirir; ikincisi yerel modelleri listeler. Model boyutu, kullanılabilir bellek ve bağlam uzunluğu hızı etkiler. Ollama'nın [belgeleri](https://docs.ollama.com/) desteklenen modelleri ve sistem kurulumunu anlatır.

## Ollama'yı denetleme

![Ayarlar → Yapay Zeka Asistanı → Sağlayıcılar ve anahtarlar. Sunucuyu denetlemek ve bir model seçmek için sağlayıcı listesinin altındaki Ollama (yerel) öğesini genişletin.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

1. **Ayarlar → Yapay Zeka Asistanı → Sağlayıcılar ve anahtarlar** bölümünü açın.
2. **Ollama**'yı genişletin.
3. **Ollama'yı denetle** seçeneğini belirleyin.
4. Durumu ve kurulu model listesini inceleyin.

Uygulama kurulu ama durdurulmuş bir Ollama bulursa **Ollama'yı başlat** onu başlatır. Sunucu başladıktan ya da başka bir model indirdikten sonra **Yeniden denetle** seçeneğini belirleyin.

## Yerel bir model seçme

Algılanan listeden bir model seçin ve uygulamak için kartın eylemini kullanın. Asistanı açın ve ileti göndermeden önce yerel modelin seçili olduğunu doğrulayın.

Bunu bir alıştırma belgesiyle deneyin:

> Bu belgenin yapısını açıkla. Herhangi bir dosyayı değiştirmeden bölümlerini listele.

Düzenlemeler veya derleme için, Oleafly'nin gerektirdiği araç davranışını destekleyen bir model kullanın. Modelin yetenek sonucuna bakın; sohbet edebilen bir model, güvenilir bir araç iş akışını otomatik olarak yürütebilir demek değildir.

## Ana makineyi değiştirme

Ollama sunucu adresini düzenlemek için **Ana makineyi değiştir (gelişmiş)** seçeneğini belirleyin. Her zamanki yerel ana makine `http://127.0.0.1:11434` adresidir. Yerleşik Ollama kartını sunucu ana makinesiyle kullanın; `/v1` eki, OpenAI uyumlu bir uç nokta yapılandırmasına aittir.

Başka bir bilgisayarda çalışan bir sunucu, bir ağ bağlantısıdır. İşlemenin bu bilgisayarda kalmasını istediğinizde yerel geri döngü adresini kullanın.

## Bunun yerine uyumlu bir sağlayıcı kullanma

Özel bir OpenAI uyumlu bağlantı için Ollama'nın `http://localhost:11434/v1/` uç noktasını kullanın. Ollama, uyumluluk istemcisinin zorunlu API anahtarı alanını kabul eder ve onu bir bulut kimlik bilgisi olarak görmez. [Ollama'nın uyumluluk kılavuzuna](https://docs.ollama.com/api/openai-compatibility) ve [özel sağlayıcılara](/docs/ai-setup/#add-a-custom-endpoint) bakın.

## Derlemeyi çevrimdışına hazırlama

Bağlıyken belgeyi açın ve başarıyla derleyin. Tectonic eksik TeX paketlerini gerektiği gibi indirir ve önbelleğe alır; Typst da Typst Universe paketleri için aynısını yapar. Ardından **Ayarlar → Genel → Çevrimdışı kip** seçeneğini etkinleştirin ve önbelleğin yeterli olup olmadığını denetlemek için yeniden derleyin. Çevrimdışı kip LaTeX ve Typst'ı kapsar.

Bir Typst projesi kendi paketlerini de barındırabilir. Typst araç çubuğundan **Typst paketleri**'ni açın ve **Paketleri projeye kopyala** seçeneğini belirleyin. Oleafly, projenin içe aktardığı paketleri bir `typst-packages` klasörüne kopyalar; böylece proje çevrimdışı ve başka bilgisayarlarda derlenir.

Bir sistem TeX motoru için, bağlantıyı kesmeden önce gerekli dağıtımı ve paketleri kurun. Görselleri, kaynakça dosyalarını, dahil edilen bölümleri ve gerekli yazı tiplerini yerel olarak erişilebilir tutun.

## Ağ bağlantısı olmadan sınama

1. Kullanacağınız projeyi açın.
2. Ollama'nın çalıştığını ve indirilen modelin seçili olduğunu doğrulayın.
3. Ağ bağlantısını kesin.
4. Belgeyi derleyin.
5. Yerel modelden bir paragrafı açıklamasını isteyin.
6. İhtiyacınız olan belirli düzenleme veya araç iş akışını deneyin ve sonucu inceleyin.

Yazma, yerel dosyalar, önbelleğe alınmış derleme ve yerel model istekleri sürdürülebilir. Çevrimiçi kaynak keşfi, GitHub eşitlemesi, bulut modelleri ve ağ MCP hizmetleri kendi bağlantılarına gerek duyar. Oleafly'nin Çevrimdışı kipi, önbelleğe alınmış derlemeyi ve atıf aramalarını denetler; sistem genelinde bir ağ güvenlik duvarı değildir.

## Ollama bağlantısını kesme

Oleafly'nin kayıtlı bağlantısını kaldırmak için sağlayıcı kartındaki **Bağlantıyı kes** düğmesini kullanın. Bu, Ollama'ya kurulu modelleri silmez.

## Sorun giderme

### Çalışmıyor

Ollama'yı başlatın, ana makineyi ve bağlantı noktasını doğrulayın, ardından yeniden denetleyin. Sunucu, bağlantı noktasının zaten kullanımda olduğunu bildirirse, başka bir örnek başlatmadan önce mevcut örneği inceleyin.

### Kurulu model yok

`ollama list` komutunu çalıştırın. Bir model indirin, indirmenin bitmesini bekleyin ve Oleafly'de yeniden denetleyin.

### Model yanıt veriyor ama araçları kullanmıyor

Yetenek durumunu inceleyin ve araç destekli bir model deneyin. Uzun bir düzenleme ve derleme dizisi istemeden önce, projeyi okuyan küçük bir istekle başlayın.

### Yanıtın soruyla ilgisi yok

Modelin bağlamı muhtemelen çok küçük. Oleafly'nin proje yönergeleri ve araçları, iletinizden önce yer kaplar; 4.096 belirteçlik bir bağlam kısa bir isteği bile kesebilir. Ollama sunucusunu en az 16.384 belirteçlik bağlamla başlatın, örneğin:

```sh
OLLAMA_CONTEXT_LENGTH=16384 ollama serve
```

Windows PowerShell'de `$env:OLLAMA_CONTEXT_LENGTH = "16384"` komutunu çalıştırın, sonra `ollama serve`. Önce çalışan herhangi bir Ollama'yı kapatın. Bu ayar Ollama sunucusuna aittir, Oleafly'ye değil. Daha uzun konuşmalar ve daha büyük projeler daha fazla bağlam gerektirir; daha fazla bağlam da daha fazla bellek kullanır. Ayrıntılar Ollama'nın [bağlam uzunluğu kılavuzundadır](https://docs.ollama.com/context-length).

### Yerel yanıt yavaş

Daha küçük bir model ya da daha kısa ve odaklı bir istek deneyin. Bir defada tüm tez incelemesi istemek yerine ilgili dosyayı veya bölümü ekleyin.
