Muharrir

1.0.0

Star
Türkçe teknik makale yazım denetleyicisi — yerel LLM + RAG ile. Turkish technical article wording checker powered by local LLM and RAG.
cli linting llm macos nlp ollama rag swift swiftui turkish lint writing-assistant
alpozcan/yazman

What's New

v1.0.0

2026-02-22T20:16:37Z

Yazman v1.0.0

Türkçe teknik makale yazım denetleyicisi — yerel LLM + RAG ile.

Özellikler

  • Paragraf denetimi (check) — Makaleyi paragraf paragraf Türkçe dil kontrolünden geçirir
  • Bütünsel inceleme (review) — Makaleyi akış, ton, tutarlılık açısından değerlendirir
  • İyileştirme önerileri (improve) — RAG corpus'unu referans alarak somut kelime/ifade önerileri sunar
  • Anlamsal arama (search) — Corpus'ta cosine similarity ile arama yapar
  • Web kazıma (scrape) — Türkçe teknik makaleleri web'den tarar ve indeksler
  • Yerel dosya ekleme (add) — Markdown/text dosyalarını corpus'a ekler

Teknik Detaylar

  • Swift 6.0, macOS 13+
  • ollama-swift ile yerel Ollama entegrasyonu
  • Actor tabanlı vektör deposu (cosine similarity, JSON disk)
  • Metin modeli: gemma3:4b | Embedding modeli: nomic-embed-text
  • 70 birim testi, SwiftLint strict CI

Kurulum

git clone https://github.com/alpozcan/yazman.git
cd yazman
swift build -c release
cp .build/release/yazman /usr/local/bin/

Ollama gereklidir:

brew install ollama
brew services start ollama
ollama pull gemma3:4b
ollama pull nomic-embed-text

Full Changelog: https://github.com/alpozcan/yazman/commits/v1.0.0

Muharrir

Türkçe teknik makale yazım denetleyicisi — yerel LLM + RAG ile.

Release Swift Package Manager Mint Homebrew Swift 6.0+ CI License

Muharrir, Türkçe teknik makalelerin dilini ve ifade biçimini yerel LLM (Ollama) ve RAG (Retrieval-Augmented Generation) kullanarak denetler ve iyileştirme önerileri sunar. Verileriniz makinenizden çıkmaz.

Kurulum

Homebrew

brew tap alpozcan/muharrir
brew install muharrir

Mint

mint install alpozcan/muharrir

Swift Package Manager (kaynak koddan derleme)

git clone https://github.com/alpozcan/muharrir.git
cd muharrir
swift build -c release
cp .build/release/muharrir /usr/local/bin/

Gereksinimler

Muharrir, Ollama'nın yerel olarak çalışmasını gerektirir:

brew install ollama
brew services start ollama
ollama pull gemma3:4b            # Metin üretimi
ollama pull nomic-embed-text     # Embedding'ler

Kullanim

Corpus oluşturma

Makaleleri corpus'a ekleyerek RAG bağlamı oluşturun:

# Yerel markdown dosyaları ekle
muharrir add makale.md diger-makale.md

# Web'den Türkçe teknik makaleleri tara
muharrir scrape https://example.com/swift-makale

# Seed URL'lerden otomatik keşif
muharrir scrape --discover

Dil denetimi

# Paragraf paragraf dil kontrolü (RAG destekli)
muharrir check makale.md

# RAG olmadan kontrol
muharrir check makale.md --no-rag

# Bütünsel makale incelemesi
muharrir review makale.md

# Somut kelime/ifade iyileştirme önerileri
muharrir improve makale.md

Arama ve istatistik

# Corpus'ta anlamsal arama
muharrir search "Swift macro kullanımı"

# Sonuç sayısını belirle
muharrir search "async defer" -n 10

# Corpus ve model istatistikleri
muharrir stats

Nasil Calisiyor?

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│  Makaleler  │────▶│  Embedding Model │────▶│ Vector Store│
│  (.md)      │     │ (nomic-embed)    │     │ (JSON disk) │
└─────────────┘     └──────────────────┘     └──────┬──────┘
                                                    │
┌─────────────┐     ┌──────────────────┐            │ RAG
│   Analiz    │ ◀───│    LLM Model     │◀───────────┘
│   Çıktısı   │     │  (gemma3:4b)     │
└─────────────┘     └──────────────────┘
  1. Corpus: Türkçe teknik makaleler chunk'lara bölünür ve nomic-embed-text ile embedding'leri oluşturulur
  2. RAG: Kontrol edilen makaleye en benzer chunk'lar cosine similarity ile bulunur
  3. LLM: Referans metinlerle birlikte gemma3:4b modeline gönderilir ve Türkçe yazım önerileri üretilir

Tüm işlem yerel makinenizde gerçekleşir — veri dışarı çıkmaz.

Teknik Detaylar

Bileşen Teknoloji
Dil Swift 6.0, macOS 13+
CLI Framework swift-argument-parser
LLM İstemci ollama-swift
HTML Ayrıştırma SwiftSoup
Terminal Renkleri Rainbow
Metin Modeli gemma3:4b
Embedding Modeli nomic-embed-text
Vector Store Actor-tabanlı, cosine similarity, JSON disk
Chunking 500 karakter, 100 karakter overlap
CI/CD GitHub Actions (build + test + SwiftLint)
Testler 70 birim testi

Komutlar

Komut Açıklama
muharrir add <dosyalar...> Yerel dosyaları corpus'a ekle
muharrir scrape [url'ler...] Web'den makale tara ve indeksle
muharrir check <makale> Paragraf paragraf dil denetimi
muharrir review <makale> Bütünsel makale incelemesi
muharrir improve <makale> RAG tabanlı iyileştirme önerileri
muharrir search <sorgu> Corpus'ta anlamsal arama
muharrir stats Corpus ve model istatistikleri

Lisans

MIT

Geliştirme

# Derleme
swift build

# Testleri çalıştır
swift test

# Lint kontrolü
swiftlint --strict

Katkida Bulunma

Katkılarınızı bekliyoruz! Detaylar için CONTRIBUTING.md rehberine bakın.

Kısaca: issue açın, fork'layın, değişiklik yapın, swift test ve swiftlint --strict ile doğrulayın, PR gönderin.

Description

  • Swift Tools 6.0.0
View More Packages from this Author

Dependencies

Last updated: Sun Mar 22 2026 16:26:46 GMT-0900 (Hawaii-Aleutian Daylight Time)