Başlangıç

Temel toolchain

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

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

UI açmadan önce ortamı doğrula

En küçük güven kontrolüyle başla:

python main.py doctor

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.

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ı.

Ana yüzeyleri ayağa kaldır

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

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

Ink control room'u aç:

agentic-trader

Web GUI'yi ç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

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

doctor çıktısı
CLI ya da observer yüzeyindeki runtime durumu
son runtime logları
model servisinin hazır oluşu
root repo ile iç içe Next uygulamaları arasındaki environment farkları

Yakın dönem onboarding yönü

Hedeflenen V1 hardening yolu şu:

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

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

On this page