Başlangıç

İlk başarılı kurulumun amacı

İlk başarılı kurulum, herhangi bir paper cycle öncesinde üç şeyi kanıtlamalı:

• lokal Python runtime başlayabiliyor
• provider, model, broker ve runtime-mode hazır oluşu görünür
• operatör yüzeyleri alt katman gerçeğini yansıtıyor, kendi state'ini uydurmuyor

Aşağıdaki kontrollerle başla. Biri başarısızsa Web GUI, Ink TUI ya da background service'e güvenmeden önce o katmanı düzelt.

Kaynaktan kurulum gereksinimleri

Depo şu anda Python artı Node workflow'u varsayıyor. Asıl trading logic hâlâ Python runtime içinde; webgui/, docs/ ve tui/ root pnpm workspace üzerinden yönetiliyor.

Önerilen temel kurulum:

• uv-managed .venv üzerinden Python 3.13.x
• Python bağımlılık yönetimi için uv
• Node 20+ ve pnpm
• İsteğe bağlı olarak tmux, asciinema ve QA için tarayıcı araçları
• Varsayılan lokal model yolunu kullanıyorsan isteğe bağlı Ollama
• Araştırma helper'larını açıkça etkinleştiriyorsan isteğe bağlı Firecrawl ve Camofox

Her şeyi kurmadan önce system-tool dry-run çalıştır:

make bootstrap-dry-run

Plan doğru görünüyorsa interaktif bootstrap kullan:

make bootstrap

Bu akış system install, browser-helper dependency, Firecrawl setup veya PATH symlink değişikliklerinden önce sorar. Eksik opsiyonel research helper'ları core paper operation için blocker değil, degraded readiness bilgisidir.

Python runtime'ı kur

uv python install 3.13
pnpm run install:python

Node workspace'i repo root'undan kur:

pnpm install
pnpm approve-builds --all

uv hazır olduktan sonra aşağıdaki kısayollardan birini kullan:

pnpm run setup
# veya
make setup

Trading öncesi hazır oluşu kontrol et

Bir paper cycle öncesinde bu kontrolleri çalıştır:

python main.py doctor
agentic-trader provider-diagnostics --json
agentic-trader v1-readiness --json
agentic-trader finance-ops --json

Kurulu CLI entrypoint'ine güveniyorsan onu da doğrula:

agentic-trader doctor

Bunu Web GUI ya da Ink TUI debug etmeden önce yap. doctor zaten yanlışsa UI çoğu zaman alt katmandaki gerçek problemi sadece yansıtıyordur. provider-diagnostics mevcut source ladder'ı, API-key hazır oluşunu ve fallback uyarılarını secret yazmadan ya da eksik evidence'ı tamam sanmadan gösterir. v1-readiness lokal paper operation ve Alpaca paper readiness kapılarının geçip geçmediğini gösterir; özellikle model servisini de çağırmak istiyorsan --provider-check ekle.

Readiness ne anlama gelir

Ortam dosyalarını yapılandır

Proje örnek artı lokal override düzenini kullanıyor.

• Root runtime ayarları .env.local içinde olmalı.
• Track edilen örnekler .env.example içinde kalmalı.
• GitHub Pages docs build'i docs/.env.local gerektirmez.

Pages üzerindeki docs feedback, tarayıcı içinde GitHub issue taslağı hazırlar. İleride Node-hosted bir docs örneği server-side forwarding'i yeniden açarsa credential'lar docs/.env.local içinde kalmalı ve track edilen config'e girmemeli.

Lokal model kurulumu

Depo varsayılan olarak hâlâ Ollama yönelimli, fakat yön giderek provider-aware hâle geliyor. Tipik lokal model ayarları şöyle görünebilir:

export AGENTIC_TRADER_MODEL_NAME=qwen3:8b
export AGENTIC_TRADER_BASE_URL=http://localhost:11434/v1

Sadece Ollama trafiğini görmeyi sistemin sağlıklı olduğunun kanıtı sayma. Model erişimi, runtime ready oluşu ve son loglar birbiriyle uyumlu olmalı.

Agentic Trader'ın bu proje için lokal Ollama sürecini yönetmesini istiyorsan, önce read-only status'a bak, sonra app-owned servisi başlat:

agentic-trader model-service status --json
agentic-trader model-service start
agentic-trader model-service pull qwen3:8b

App-managed servis yalnızca loopback'e bind eder, kendi state/log tail'lerini runtime/model_service/ altına yazar ve dışarıdan başlatılmış bir Ollama process'ini durdurmaz. Varsayılan portta başka Ollama çalışıyorsa yakındaki başka bir loopback port seçer ve AGENTIC_TRADER_BASE_URL ile eşleşip eşleşmediğini görünür kılar. Eski app-managed portlar stop/start sırasında temizlenir; 11434 üzerindeki servis kullanıcı/host Ollama olarak kalır.

Tek bir güvenli paper cycle çalıştır

Tek bir strict cycle çalıştır:

python main.py run --symbol AAPL --interval 1d --lookback 180d

Sonrasında bu koşuyu güvenilir bir örnek saymadan önce review çıktısını, dashboard/status JSON'u ve varsa evidence bundle'ı incele.

Ana yüzeyleri ayağa kaldır

Operatör launcher'ı aç:

agentic-trader

Ink control room'u doğrudan aç:

agentic-trader tui

Web GUI'yi app-owned loopback service olarak çalıştır:

agentic-trader webgui-service start

Ya da foreground development server olarak çalıştır:

pnpm dev:webgui

Docs sitesini lokal çalıştır:

pnpm dev:docs

Ink TUI'yi doğrudan çalıştır:

pnpm start:tui
AGENTIC_TRADER_UI_LOCALE=tr pnpm start:tui

Terminal yüzeyleri Python tarafındaki locale ayarını paylaşır. agentic-trader --locale tr locale --json tek komutluk ön izleme yapar; agentic-trader locale --set tr ise AGENTIC_TRADER_UI_LOCALE=tr değerini yerel environment dosyasına yazar.

Bir şey ters hissedildiğinde önce bakılacak yerler

• doctor çıktısı
• provider-diagnostics --json
• v1-readiness --json
• broker-status --json
• finance-ops --json
• supervisor-status --json
• CLI ya da observer yüzeyindeki runtime durumu
• son runtime logları
• model servisinin hazır oluşu
• son review veya trade context
• root repo ile iç içe Next uygulamaları arasındaki environment farkları

Yakın dönem onboarding yönü

Hedeflenen V1 hardening yolu şu:

1. platforma göre prerequisite tespiti
2. isteğe bağlı provider ve model kurulumu
3. Python ve Node ortamlarının hazırlanması
4. ready oluş doğrulaması
5. doğru lokal yüzeyin otomatik açılması

Bu gelecek akışın amacı sürtünmeyi azaltmak; hataları gizlemek değil.