🚀 Pitrat Trading Bot v1.0 — TUI Edition

Высокопроизводительный асинхронный торговый бот, спроектированный для запуска одной командой. Весь контроль — в одном терминальном окне (TUI). Построен на принципах Clean Architecture для институциональной надежности.

🌟 Основные возможности

• One-Click TUI Dashboard: Полноценный торговый терминал прямо в консоли. Управление, графики, сделки и настройки в одном окне.
• Housewife-Ready: Автоматическая настройка окружения, баз данных и зависимостей при первом запуске.
• Институциональные Стратегии:
  • V5 Momentum: Трендовая стратегия на ATR и MACD с Hurst-фильтром.
    • Механика: Входит при подтверждении силы тренда через ADX (>25) и пересечении MACD. Hurst Guard блокирует входы в "шумных" боковиках.
    • Риск: Использует фиксированный процент Келли для расчета позиции.
  • V8 Hybrid-X: Скальпинг по дисбалансу объемов (Order Book Imbalance).
    • Механика: Анализирует L2-стакан Binance. Входит при резком преобладании лимитных заявок одной стороны. Динамический стоп-лосс на базе Yang-Zhang волатильности.
    • Особенность: Высокая частота сделок на волатильных рынках.
  • V16 Apex-Hybrid: Адаптивное переключение режимов Trend/Range.
    • Механика: Скрытые Марковские Модели (HMM) определяют состояние рынка. Переключается между агрессивным тренд-фолловингом и спокойным возвратом к среднему (Mean Reversion).
  • V20 Omni-Adaptive: Использование ML (XGBoost) для фильтрации сигналов.
    • Механика: Финальный цензор для всех сигналов. Обучен на исторических данных 2024-2025 гг. Оценивает вероятность успеха сделки (Win Probability) перед отправкой ордера.
• Умный Риск-Менеджмент:
  • Dynamic Risk: Автоматический расчет лота на основе баланса.
  • Panic Sell / Kill Switch: Экстренное закрытие всех позиций одной кнопкой (K).
  • Hurst Guard: Бот не входит в сделку при рыночном шуме.
• Docker & Hybrid Support: Работает как в Docker контейнерах, так и локально с автоматическим переключением на SQLite, если Docker недоступен.

🛠 Быстрый старт

1. Запуск (все включено)

Просто запустите главный скрипт. Он сам создаст виртуальную среду, установит библиотеки и запустит мастер настройки, если вы запускаете бота впервые:

./start.sh

Если у вас есть Docker — бот запустится в контейнере. Если нет — запустится локально.

2. Управление в TUI (Горячие клавиши)

• F1 — Дашборд (Общий статус)
• F2 — График (Live-данные)
• F3 — Сделки (История и открытые позиции)
• F4 — Журнал (Заметки трейдера)
• F5 — Логи (Техническая информация)
• F6 — Настройки (Смена стратегий и ключей на лету)
• S — Старт / Стоп движка
• P — Пауза (Toggle)
• K — Kill Switch (Закрыть всё и выйти)

💻 Управление через CLI (Agent-Friendly)

Бот поддерживает расширенное управление через терминал, что позволяет внешним AI-агентам (через MCP) контролировать процесс:

• python pitrat.py status — Текущее состояние, профит и открытые позиции.
• python pitrat.py stop — Безопасная остановка запущенного бота.
• python pitrat.py pause / resume — Управление паузой.
• python pitrat.py kill — Экстренное закрытие всех позиций.
• python pitrat.py check — Проверка здоровья системы (API, DB, Config).

🏗 Архитектура (Clean Architecture + Orchestrator)

Проект спроектирован так, чтобы изменения в интерфейсе (TUI) не могли сломать торговую логику:

• src/application/orchestrator.py: "Мозговой центр", который изолирует UI от Core. Управляет жизненным циклом воркера и гарантирует стабильность.
• src/domain: Ядро бота — торговые стратегии, риск-менеджмент и правила входа.
• src/application: Исполнение ордеров, управление позициями и фоновые воркеры.
• src/infrastructure: Хранилище (SQLite/PostgreSQL), адаптеры бирж (CCXT) и кэш (Redis).
• src/ui/tui: Интерфейс управления. Теперь он является "тонким клиентом" к оркестратору.
• src/mcp_server.py: Реализация Model Context Protocol для управления ботом через LLM агентов.

---

Happy Trading! 🎯