typesafe-computer-use: Adım Başına $0.0002 Maliyetle Mac Yönetimi

Giriş ve Temel Mimari

typesafe-computer-use, doğal dilde verilen hedeflere göre bir Mac bilgisayarı adım başına yaklaşık sentin 50'de biri (~$0.0002) maliyetle yöneten yenilikçi bir açık kaynak projesidir. Sistem, her adımda büyük ve pahalı çok modlu modellere tam ekran görüntüsü göndermek yerine deterministik bir döngü uygular: Ekranı OCR ile okur, küçük bir sınıflandırıcı modele sıradaki eylemi sorar ve serbest metin girişi gerekmedikçe büyük yazma modellerini devreye sokmaz.

CLI üzerinden pratik kullanım örneği: clicker "go to techcrunch and take me to the checkout page for the cheapest tickets to their next upcoming event" --act

Neden Bu Yaklaşım?

Frontier modeller (Claude Opus vb.) çok yetenekli olsalar da oldukça maliyetlidir; her adımda tam ekran görüntüsü işler ve planlama için birkaç saniye bekler. Oysa bilgisayar kullanım döngülerindeki adımların büyük çoğunluğu geniş çaplı bir plan gerektirmez; kısa bir seçenek listesinden güvenle tek bir eylem seçmeyi gerektirir. TypeSafe, 255 seçeneğe kadar tam olasılık dağılımı ve kalibre edilmiş güven skoru sunarak yüz milisaniyeler içinde karar verir ve çıktı token ücreti almaz.

Performans ve Maliyet Karşılaştırması

Aynı ekran görüntüsü ve hedef üzerinde typesafe (jev) ile Claude Opus 5 modelleri kıyaslandığında:

Girdi Token Sayısı: 4.882'ye karşı 4.785 (benzer düzeyde).
Karar Başına Maliyet: $0.0002'ye karşı $0.032 (155 kat daha ucuz).
Geçmişli Döngüde Karar Maliyeti: $0.0002'ye karşı $0.035 - $0.08 (170 ila 390 kat daha ucuz).
12 Adımlı Görev Maliyeti: $0.003'e karşı $0.40 - $0.90 (130 ila 300 kat daha ucuz).
Model Gecikmesi: 0.13 - 0.38 saniyeye karşı 5.2 saniye (14 ila 40 kat daha hızlı).
Uçtan Uca Adım Süresi (Yakalama ve OCR dahil): ~1.5 saniyeye karşı ~5.5 saniye (3.7 kat daha hızlı).

Pratik Geliştirici Çıkarımı ve Çekinceler

Frontier modeller piksellerdeki etkinlik tarihlerini doğrudan okuyup kıyaslayabilirken, küçük sınıflandırıcılar harici tarih ayrıştırma mantığına ihtiyaç duyar. Yazılım mimarisi açısından temel çıkarım şudur: Büyük modellerin örtük yürüttüğü akıl yürütme adımlarını, maliyeti radikal şekilde düşürmek adına deterministik durum makineleri ve kod parçaları olarak yeniden inşa etmek gerekir.

Kurulum ve Ortam Değişkenleri

macOS 14+ ve Python 3.12+ (uv) gerektiren projenin kurulum adımları:

Depoyu klonlayın: git clone https://github.com/awlevin/typesafe-computer-use
Proje dizinine geçin: cd typesafe-computer-use
Bağımlılıkları yükleyin: uv sync
Ortam dosyasını kopyalayın: cp .env.example .env

Yapılandırma değişkenleri 6 parametreden oluşur:

TYPESAFE_API_KEY: Zorunlu; tüm kararları yönlendirir.
ANTHROPIC_API_KEY: İsteğe bağlı; type_text, önerilen URL'ler ve nihai yanıt için.
CLICKER_EMAIL: İsteğe bağlı; type_email eylemini aktif kılar.
CLICKER_BROWSER: İsteğe bağlı; varsayılan Google Chrome.
CLICKER_WRITER_MODEL: İsteğe bağlı; varsayılan claude-haiku-4-5.
CLICKER_ANSWER_MODEL: İsteğe bağlı; son ekranı okur, varsayılan claude-sonnet-5.

Son olarak, macOS Sistem Ayarları > Gizlilik ve Güvenlik altından Terminal'e Ekran Kaydı ve Erişilebilirlik izinleri tanımlanmalıdır; aksi takdirde ekran okunamamakta veya tıklamalar iletilememektedir.

[Orijinal kaynağa buradan ulaşabilirsiniz.](https://github.com/awlevin/typesafe-computer-use)

Bu konuyu derinlemesine öğrenmek isterseniz: Tool Calling ve Multi-Step Agent'lar modülüne göz atın.