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 是一个开源、自托管的 AI 交易终端,由语言模型充当交易策略,自动交易加密货币、美股、大宗商品和外汇,同时由 Go 运行时强制执行模型无法覆盖的硬性风险限制。
这是云服务,还是需要在我自己的电脑上运行的软件?这是自托管软件,需要你在自己的电脑或服务器上运行;包括交易所凭证在内的所有数据都保存在该机器本地。
我该怎么把它跑起来?在 Linux/macOS 上使用提供的安装脚本安装(或通过 Railway 或 Docker 部署,Windows 上需要 Docker Desktop),以所有者身份注册第一个账户,然后按照引导步骤启动:向 AI 手续费钱包充入至少 1 美元的 Base 链 USDC,连接 Hyperliquid 等交易所,存入至少 12 美元的 USDC,然后启动 Autopilot。
运行它是否需要我自己的 AI 模型 API 密钥?你可以自带 DeepSeek、OpenAI、Claude、Qwen、Gemini、Grok、Kimi 或 MiniMax 的密钥;也可以完全不用密钥,改为通过 Claw402 按次付费,它使用 x402 协议以 USDC 计量用量,只需要一个 Base 链上的钱包。
AI 交易会不会没有任何安全保障?不会——每笔订单都要经过代码强制执行的限制,模型无法覆盖,包括仓位和杠杆上限、自动止损/止盈、回撤自动平仓、交易频率限制,以及在模型反复失败后阻止新开仓的安全模式。
我的交易所凭证会去哪里?凭证会加密存储,并且永远不会离开你的电脑,因为整个系统都在本地运行。
AGPL-3.0 许可证对我意味着什么?NOFX 依据 AGPL-3.0 免费开源,但项目明确指出,自动化交易存在真实的财务风险,AI 驱动的策略可能会亏损。
NOFX 实际能交易哪些市场?支持的九家交易所(Binance、Bybit、OKX、Hyperliquid、Bitget、KuCoin、Gate、Aster、Lighter)均可交易加密货币永续合约;此外,在 Hyperliquid 上还可以交易代币化的美股、大宗商品、指数、外汇,以及 IPO 前永续合约,如 TSLA、NVDA、GOLD 和 SPX。
我能同时运行多个交易策略吗?可以,你可以同时运行多个交易者,使用不同的模型或策略,并在公开排行榜上比较它们的表现,排名依据是已实现收益率。
AI 的决策有审计记录吗?每个决策都会连同模型的完整推理过程一起存储,因此没有任何持仓是在没有记录理由的情况下建立的。
我能自定义交易者的行为吗?Strategy Studio 允许你为每个交易者设置风格预设、币种范围、指标、杠杆、入场信心度和自定义提示词。
Creator
NoFxAiOS
Size
70.4 MB
Stars
13.1K
Updated
CommitOct 16
Age
11mo
Commits · 90 Days