Ana içeriğe geç

Kurulum

tau bir Python paketleri kümesidir. tau-core ajanı ve tau komutunu barındırır; tau-tui ise Textual arayüzünü ekler. Onları bir kez kurarsın, tau init ile bir yapılandırma kökü oluşturursun, tau doctor ile kontrol edersin ve konuşmaya başlarsın.

Gereksinimler

  • Python 3.12 veya daha yenisi. Daha eskisi çalışmaz; paketler requires-python = ">=3.12" bildirir.
  • uv, tau'nun çalışma alanının (workspace) üzerine kurulduğu Python paket yöneticisi. Hiç Python'un yoksa kendi Python'unu kurar.
  • macOS ya da Linux. Hub (tau'nun çalıştığı, sana ait makine) bugün bir MacBook'ta, ileride bir Raspberry Pi 5'te çalışacak; aynı kod ikisinde de çalışır.
  • Bir model sağlayıcısı ya da hiçbiri. tau, hiçbir hesap olmadan her şeyi deneyebilmen için senaryolu bir fake sağlayıcıyla gelir. Gerçek yanıtlar için Anthropic, OpenAI ya da Google Gemini'den bir API anahtarı veya Ollama üzerinden yerel bir model gerekir (bkz. İlk çalıştırma). tau sağlayıcıyı doğrudan çağırır ve rol başına harcama üst sınırını kendisi uygular; bu yüzden yanında başka hiçbir şeyin çalışması gerekmez (Modeller ve bütçeler).
brew install uv
uv python install 3.12

curl -LsSf https://astral.sh/uv/install.sh | sh
uv python install 3.12

İpucu

uv python install 3.12 isteğe bağlıdır. Bir proje ihtiyaç duyduğunda uv uygun bir yorumlayıcıyı kendiliğinden indirir.

Paketleri kur

Bunun yerine depodan

Katkıda bulunanlar ve henüz yayımlanmamış main dalını isteyen herkes uv çalışma alanından kurar ve her komutu uv run üzerinden çalıştırır:

git clone https://github.com/fport/tau.git
cd tau
uv sync --all-packages --group dev
uv run tau --help

Aşağıdaki her şey aynen geçerli; checkout'un (deponun yerel kopyası) içindeyken tau … komutlarını uv run tau … olarak oku. Depo kökünde bir tau.toml bulunur, yani başka bir yerde tau init çalıştırana kadar orası aynı zamanda yapılandırma köküdür. O dosya brain ve fast rollerini bütçeleriyle Anthropic'e, local rolünü de Ollama'ya koyar; bu yüzden checkout'un .env dosyasında ANTHROPIC_API_KEY gerekir. Başka bir sağlayıcı kullanıyorsan tau init'in o sağlayıcı için yazdığı bir kök kullan.

Paketler yayımlandığında belgelenen kurulum, tau'yu TUI dahil olarak PATH'ine koyan tek bir uv tool komutudur:

uv tool install tau-core --with tau-tui
tau --help

uv tool install, tau'yu kendi sanal ortamında tutar ve sistem Python'una asla dokunmaz. Sonradan uv tool upgrade tau-core ile yükselt.

Bir yapılandırma kökü oluştur

tau init, tau'nun ihtiyaç duyduğu dosyaları bir yapılandırma köküne, varsayılan olarak ~/.tau dizinine yazar:

tau init

Tek bir soru sorar, arayüz dilini (en ya da tr), ardından şunları yazar:

Dosya Nedir
tau.toml Her rolü hangi sağlayıcının ve model id'sinin karşıladığı; ayrıca ajan, oturum, hub ve arayüz ayarları. Bkz. Yapılandırma.
persona/persona.md tau'nun karakteri. Depoda takip edilir, herkese açıktır, senin hakkında hiçbir şey içermez.
persona/user.example.md Bilgi dosyasının uydurma bir örneği.
persona/user.md Örneğin senin kopyan. Onu düzenle; senin hakkındaki gerçek bilgilerin tek yeri burası.
.env.example tau doctor'ın bildiği her kimlik bilgisinin ve ayarın adı. Gerçek değerlerin hemen yanındaki .env dosyasına gider.

tau init, sağlayıcıyı görebildiği kimlik bilgilerine göre seçer: önce Anthropic (ANTHROPIC_API_KEY), sonra OpenAI (OPENAI_API_KEY), sonra Gemini (GEMINI_API_KEY ya da GOOGLE_API_KEY), sonra Bedrock, hiçbiri yoksa fake. O sağlayıcının modellerini brain ve fast için yazar, tau'nun onlar için uyguladığı bütçeleri korur (brain için ayda 15 $, fast için günde 1 $) ve local rolünü, failover'ı (ulaşılamazsa devredeceği rol) fast olacak şekilde Ollama'ya koyar. Hiç kimlik bilgisi yoksa fake sağlayıcı üzerinde çalışan bir yapılandırma ve bunu söyleyen bir not alırsın. --force vermediğin sürece mevcut dosyalar korunur; user.md ve .env.example asla üzerine yazılmaz.

Kök nerede?

tau, tau.toml dosyasını şu sırayla arar: --home DIR seçeneği, TAU_HOME değişkeni, içinde bir tau.toml varsa geçerli dizin, sonra ~/.tau. Değişen durum (oturumlar, loglar, hub dosyaları) başka bir yerde, TAU_DATA_DIR altında yaşar; varsayılanı ~/.local/share/tau. Bkz. Ortam değişkenleri.

Kurulumu kontrol et

tau doctor

tau doctor yapılandırmayı okur, bir model istemcisi oluşturmadan her rolün sağlayıcısını ve kimlik bilgilerini kontrol eder, oturum deposunu açar, persona dosyalarını okur, .env dosyasını .env.example ile karşılaştırır, her bileşeni yükler ve hub'ı yoklar. Yalnızca bir kontrol başarısız olduğunda 1 ile çıkar; başlangıç için uyarılar sorun değil. İlk çalıştırma çıktıyı satır satır anlatır.

Konuş

tau chat

tau ready. Profile: home, session: 20260929-173826-f949. Commands: /help, /tools, /sessions, /resume, /new, /session, /compact, /clear, /status, /model, /lang, /settings, /quit (Ctrl-D also quits).
you>

Bir mesaj yaz ve Enter'a bas. /help komutları listeler, /quit çıkar. fake sağlayıcıda tau her şeye Okay. diye yanıt verir; bu bir hata değil, senaryolu model. Gerçek yanıtlar için kimlik bilgisi ekle: TUI'de /settings (ya da burada /settings set ANTHROPIC_API_KEY) onları .env dosyasına yazar ve rolü değiştirir; ya da onları .env dosyasına kendin koy ve tau init --force komutunu yeniden çalıştır.

Tam ekran arayüz bir komut uzağında:

tau tui

tau ile konuş ikisini karşılaştırır ve her tuşu ve komutu listeler.

Sıradaki