# NOFX - AI Торгова Система

[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/)
[![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)

**Мови:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](README.md)

---

## Криптовалютна торгова платформа на базі ШІ

**NOFX** — це open-source AI торгова система, що дозволяє запускати кілька AI моделей для автоматичної торгівлі криптовалютними ф'ючерсами. Налаштовуйте стратегії через веб-інтерфейс, відстежуйте ефективність у реальному часі та дозвольте AI агентам конкурувати за найкращий торговий підхід.

### Основні функції

- **Мульти-AI підтримка**: Запускайте DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi — перемикайтеся між моделями будь-коли
- **Мульти-біржа**: Торгуйте на Binance, Bybit, OKX, Hyperliquid, Aster DEX, Lighter з єдиної платформи
- **Студія стратегій**: Візуальний конструктор стратегій з джерелами монет, індикаторами та контролем ризиків
- **Режим AI-змагання**: Кілька AI трейдерів змагаються в реальному часі, відстеження ефективності пліч-о-пліч
- **Веб-конфігурація**: Без редагування JSON — налаштування всього через веб-інтерфейс
- **Панель реального часу**: Живі позиції, відстеження P/L, логи рішень AI з ланцюжком міркувань

> **Попередження про ризики**: Ця система експериментальна. AI автоторгівля несе значні ризики. Наполегливо рекомендується використовувати лише для навчання/досліджень або тестування з невеликими сумами!

## Спільнота розробників

Приєднуйтесь до Telegram спільноти: **[NOFX Developer Community](https://t.me/nofx_dev_community)**

---

## Швидкий старт

### Варіант 1: Docker розгортання (рекомендовано)

```bash
git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
chmod +x ./start.sh
./start.sh start --build
```

Доступ до веб-інтерфейсу: **http://localhost:3000**

### Оновлення до останньої версії

> **💡 Оновлення виходять часто.** Запускайте цю команду щодня для отримання останніх функцій та виправлень:

```bash
curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
```

Ця команда завантажує останні офіційні образи та автоматично перезапускає сервіси.

### Варіант 2: Ручна установка

```bash
# Вимоги: Go 1.21+, Node.js 18+, TA-Lib

# Встановлення TA-Lib (macOS)
brew install ta-lib

# Клонування та налаштування
git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
go mod download
cd web && npm install && cd ..

# Запуск бекенду
go build -o nofx && ./nofx

# Запуск фронтенду (новий термінал)
cd web && npm run dev
```

---

## Початкове налаштування

1. **Налаштування AI моделей** — Додайте API ключі AI
2. **Налаштування бірж** — Встановіть API облікові дані бірж
3. **Створення стратегії** — Налаштуйте торгову стратегію в Студії стратегій
4. **Створення трейдера** — Об'єднайте AI модель + Біржу + Стратегію
5. **Початок торгівлі** — Запустіть налаштованих трейдерів

---

## Попередження про ризики

1. Криптовалютні ринки надзвичайно волатильні — AI рішення не гарантують прибуток
2. Торгівля ф'ючерсами використовує плече — збитки можуть перевищити депозит
3. Екстремальні ринкові умови можуть призвести до ліквідації

---

## Ліцензія

**GNU Affero General Public License v3.0 (AGPL-3.0)**

---

## Контакти

- **GitHub Issues**: [Створити Issue](https://github.com/NoFxAiOS/nofx/issues)
- **Спільнота розробників**: [Telegram група](https://t.me/nofx_dev_community)
