# 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)
