Перейти к основному содержимому

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

Эта страница для внешних пользователей пакетов TradeJS (без клонирования репозитория).

Что нужно заранее​

  • Node.js 20.19+
  • npm/yarn/pnpm
  • Установленный и запущенный Docker Desktop (или Docker Engine)
  • Доступный Docker Compose plugin (docker compose)

1. Создайте проект и установите пакеты​

mkdir tradejs-project
cd tradejs-project
npm init -y
npm i @tradejs/app @tradejs/core @tradejs/node @tradejs/types @tradejs/base @tradejs/cli

2. Добавьте tradejs.config.ts​

import { defineConfig } from '@tradejs/core/config';
import { basePreset } from '@tradejs/base';

export default defineConfig(basePreset);

Политика импортов для плагинов:

  • импортируйте plugin registration из @tradejs/core/config
  • browser-safe helper’ы импортируйте из публичных subpath’ов @tradejs/core/*
  • Node runtime helper’ы импортируйте из публичных subpath’ов @tradejs/node/*
  • общие контракты импортируйте из @tradejs/types
  • избегайте непубличных deep-imports вроде @tradejs/core/src/* или @tradejs/node/src/*

3. Инициализируйте файлы dev-инфраструктуры​

infra-init создает docker-compose.dev.yml в корне проекта один раз. Если файл уже существует, команда его не перезаписывает.

npx @tradejs/cli infra-init

4. Поднимите dev-инфраструктуру​

infra-up использует существующий docker-compose.dev.yml и поднимает:

  • PostgreSQL/Timescale (127.0.0.1:5432)
  • Redis (127.0.0.1:6379)
npx @tradejs/cli infra-up

Важно:

  • docker-compose.dev.yml используется для локальной dev-инфраструктуры.
  • docker-compose.prod.yml предназначен для production deployment и infra-up его не использует.

5. Проверьте окружение​

npx @tradejs/cli doctor

Обычно runtime ожидает:

  • PostgreSQL/Timescale: 127.0.0.1:5432
  • Redis: 127.0.0.1:6379
  • ML gRPC (опционально): 127.0.0.1:50051

6. Базовые команды на каждый день​

npx @tradejs/cli signals
npx @tradejs/cli backtest
npx @tradejs/cli results
npx @tradejs/cli bot

7. Создайте пользователя root​

TradeJS app и CLI по умолчанию используют пользователя root. Создайте его один раз перед запуском UI:

npx @tradejs/cli user-add -u root -p 'StrongPassword123!'

Подробнее см. в Root User Setup.

8. Запустите web UI​

npx tradejs-app dev

Откройте:

  • http://localhost:3000/routes/backtest для сохраненных бэктестов
  • http://localhost:3000/routes/dashboard для графиков и сигналов

После входа:

  • откройте иконку шестеренки в левом сайдбаре, чтобы управлять настройками аккаунта
  • настройте Bybit API доступ для текущего пользователя перед работой с live-данными биржи
  • перенесите passwordless token, OpenAI и Telegram настройки в профиль пользователя, который хранится в Redis

Если порт 3000 уже занят, tradejs-app dev автоматически выберет следующий свободный порт и выведет фактический URL в консоль.

Для production-режима:

npx tradejs-app build
npx tradejs-app start

9. Остановите dev-инфраструктуру​

npx @tradejs/cli infra-down

Если что-то не стартует​

Ошибка ECONNREFUSED 127.0.0.1:6379​

Redis недоступен из вашего окружения.

Ошибка ECONNREFUSED 127.0.0.1:5432​

PostgreSQL/Timescale недоступен из вашего окружения.