nofx README

The project's README from github.com/NoFxAiOS/nofx. As one markdown file: README.md.

Backed by vergex.trade

NOFX — AI trading terminal

Stars Release License Telegram

English · 中文 · 日本語 · 한국어 · Русский · Українська · Tiếng Việt


NOFX is an open-source trading terminal where the strategy is a language model. Each trader runs a continuous loop — read market structure, decide, execute, record the reasoning — while a Go runtime clamps every order to hard risk limits the model cannot override.

Traders compose freely: any model, any of nine exchanges, any strategy. Run several side by side and compare them on a public leaderboard by realized return. Everything runs on your own machine; exchange credentials are encrypted at rest and never leave it.

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

The terminal opens at http://127.0.0.1:3000.

First run

  1. Register — the first account becomes the owner of the instance.
  2. Follow the guided launch: put $1+ USDC (Base network) in the AI fee wallet it creates for you, then connect Hyperliquid and deposit $12+ USDC to trade with.
  3. Start Autopilot. The AI scans the market every few minutes and trades on its own; every decision appears on the dashboard as it happens. Stop it anytime with one click.

Register exchanges

NOFX is free and open source. Opening an account through the partner links below carries reduced trading fees and funds continued development.

Exchange Status Register with fee discount
Binance ✅ Register
Bybit ✅ Register
OKX ✅ Register
Hyperliquid ✅ Register
Bitget ✅ Register
KuCoin ✅ Register
Gate ✅ Register
Aster ✅ Register
Lighter ✅ Register

Demo

https://github.com/user-attachments/assets/3310f495-14c5-4586-a1cc-3d32e44aa505


The model proposes. The runtime disposes.

Decisions come from the Claw402.ai · Vergex data stack: a live direction board for the market universe, per-symbol current direction and direction history, cost-basis and liquidation heatmaps, and real-time market net flow. NOFX follows the board direction and uses the remaining data as execution context.

Every order passes through limits enforced in code, outside the model's reach:

Position limits Max concurrent positions, notional capped as a ratio of equity, one position per symbol
Leverage clamps Hard caps applied at order-sizing time, independent of what the model requests
Exchange-side protection Stop-loss and take-profit placed on the exchange immediately after every entry
Drawdown auto-close Profitable positions that give back too much from their peak are closed
Trade throttling Minimum hold times, per-symbol re-entry cooldowns, per-cycle and per-hour entry limits
Safe mode Repeated model failures block new entries until the model recovers
Launch preflight Model access, wallet funds, strategy, and exchange balances verified before a trader may start

Each decision is stored with the model's full reasoning. There is no position without a paper trail.


Terminal

Autopilot Guided launch: fund, connect, deposit, start — with server-side preflight throughout
Strategy Studio Style presets, coin universes, indicators, leverage, entry confidence, custom prompts
Competition Public leaderboard ranked by realized return, each entry attributed to its model
Dashboard Live positions, orders, statistics, and the reasoning behind every decision
Screenshots
Overview Market Chart
Trading Stats Position History
Strategy Editor Indicators Config
Competition Configuration

Models

Eight providers with your own keys — DeepSeek, OpenAI, Claude, Qwen, Gemini, Grok, Kimi, MiniMax — including custom endpoints and model names.

Or no keys at all: Claw402 meters model usage per call in USDC over the x402 protocol. A wallet on Base replaces every API key.

Provider Access
Claw402 Pay-as-you-go AI models with official discount

Markets

Crypto perpetuals on all nine exchanges. On Hyperliquid, the same runtime also trades tokenized US equities, commodities, indices, FX, and pre-IPO perps — TSLA, NVDA, GOLD, SPX, EUR, OPENAI — alongside crypto.


Architecture

    ┌─────────────────────────────────────────────────┐
    │                 Trading Terminal                 │
    │        React · TypeScript · TradingView          │
    │   Dashboard · Strategy Studio · Competition      │
    ├─────────────────────────────────────────────────┤
    │                  API Server (Go)                  │
    │      JWT auth · encrypted credential store        │
    ├──────────────┬──────────────┬───────────────────┤
    │   Strategy    │  Autopilot   │   Trader Runtime  │
    │    Engine     │  Preflight   │    Risk Engine    │
    ├──────────────┴──────────────┴───────────────────┤
    │                 AI Model Layer                    │
    │  DeepSeek · OpenAI · Claude · Qwen · Gemini      │
    │  Grok · Kimi · MiniMax · Claw402 (x402 USDC)     │
    ├─────────────────────────────────────────────────┤
    │              Exchange Connectivity                │
    │ Binance · Bybit · OKX · Hyperliquid · Bitget     │
    │ KuCoin · Gate · Aster · Lighter                  │
    └─────────────────────────────────────────────────┘

Install

Linux / macOS

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

Railway

Deploy on Railway

Docker

curl -O https://raw.githubusercontent.com/NoFxAiOS/nofx/main/docker-compose.prod.yml
docker compose -f docker-compose.prod.yml up -d

Windows — install Docker Desktop, then:

curl -o docker-compose.prod.yml https://raw.githubusercontent.com/NoFxAiOS/nofx/main/docker-compose.prod.yml
docker compose -f docker-compose.prod.yml up -d

From source — Go 1.21+, Node.js 18+:

git clone https://github.com/NoFxAiOS/nofx.git && cd nofx
go build -o nofx && ./nofx            # backend
cd web && npm install && npm run dev  # frontend, in a second terminal

Update — re-run the install script; it upgrades in place.

Server deployment

HTTP

curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
# http://YOUR_IP:3000

HTTPS via Cloudflare

  1. Add the domain to Cloudflare (free plan)
  2. A record → server IP, proxied
  3. SSL/TLS → Flexible
  4. TRANSPORT_ENCRYPTION=true in .env

Documentation

Getting Started Deployment and exchange API guides
Architecture System design and module index
Strategy Module Coin selection, AI prompts, execution
FAQ Common questions
Troubleshooting Diagnosing common issues

Community

Telegram · Twitter/X · Issues · vergex.trade · Live dashboard

Contributing

Code, documentation, translations, and bug reports are all welcome — see the Contributing Guide, Code of Conduct, and Security Policy.

NOFX tracks meaningful contributions and intends to reward contributors as the ecosystem grows. Priority issues carry higher weight.

Contribution Weight
Pinned Issue PRs ★★★★★★
Code (Merged PRs) ★★★★★
Bug Fixes ★★★★
Feature Ideas ★★★
Bug Reports ★★
Documentation ★★
Contributors

Sponsors

Become a sponsor


If NOFX is useful to you, a star helps other traders find it.

Star History Chart

License

AGPL-3.0

Automated trading involves substantial risk. AI-driven strategies are experimental and can lose money. Size positions appropriately, understand each venue, and never trade funds you cannot afford to lose. Full disclaimer.

nofx (NoFxAiOS/nofx)

Searching Database…

13.1K ·GitHub
Что это такое?NOFX — это открытый торговый терминал на базе ИИ, который размещается самостоятельно. Языковая модель выступает в роли торговой стратегии и автоматически торгует криптовалютой, акциями США, сырьевыми товарами и форексом, а исполняющая среда на Go жёстко соблюдает лимиты риска, которые модель не может отменить.
Это облачный сервис или программа, которую я запускаю на своём компьютере?Это программа с самостоятельным размещением, которую вы запускаете на своём компьютере или сервере; всё, включая учётные данные биржи, остаётся локально на этой машине.
Как всё запустить?Установите программу на Linux/macOS с помощью скрипта установки (или разверните через Railway или Docker; на Windows нужен Docker Desktop), зарегистрируйте первый аккаунт как владельца, затем следуйте пошаговой инструкции запуска: пополните кошелёк для оплаты ИИ на $1+ USDC в сети Base, подключите биржу, например Hyperliquid, внесите $12+ USDC и запустите Autopilot.
Нужны ли мне собственные API-ключи ИИ-моделей, чтобы это работало?Вы можете использовать свои ключи для DeepSeek, OpenAI, Claude, Qwen, Gemini, Grok, Kimi или MiniMax либо обойтись без ключей и платить за каждый вызов через Claw402, который учитывает использование в USDC по протоколу x402, требуя только кошелёк в сети Base.
Торгует ли ИИ без всякой страховки?Нет — каждый ордер проходит через ограничения, заданные кодом, которые модель не может обойти: лимиты на размер позиций и кредитное плечо, автоматические стоп-лосс и тейк-профит, автоматическое закрытие при просадке, ограничение частоты сделок и безопасный режим, который блокирует открытие новых позиций после повторных сбоев модели.
Куда уходят мои учётные данные биржи?Они шифруются при хранении и никогда не покидают ваш компьютер, поскольку вся система работает локально.
Что для меня означает лицензия AGPL-3.0?NOFX бесплатен и имеет открытый исходный код по лицензии AGPL-3.0, однако в проекте прямо указано, что автоматическая торговля несёт реальный финансовый риск и стратегии на основе ИИ могут приносить убытки.
Какими рынками NOFX реально может торговать?Криптовалютными бессрочными фьючерсами на всех девяти поддерживаемых биржах (Binance, Bybit, OKX, Hyperliquid, Bitget, KuCoin, Gate, Aster, Lighter), а на Hyperliquid также токенизированными акциями США, сырьевыми товарами, индексами, валютными парами и бессрочными контрактами на акции до IPO, например TSLA, NVDA, GOLD и SPX.
Могу ли я одновременно запускать несколько торговых стратегий?Да, можно запускать несколько трейдеров рядом, с разными моделями или стратегиями, и сравнивать их результаты в публичном рейтинге, упорядоченном по реализованной доходности.
Ведётся ли журнал аудита решений ИИ?Каждое решение сохраняется вместе с полными рассуждениями модели, поэтому ни одна позиция не открывается без зафиксированного обоснования.
Можно ли настроить, как ведёт себя трейдер?Strategy Studio позволяет задать для каждого трейдера стили-пресеты, наборы монет, индикаторы, плечо, уверенность при входе и собственные промпты.
Creator
NoFxAiOS
Size
70.4 MB
Stars
13.1K
Updated
CommitOct 16
Age
11mo
Commits · 90 Days