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)

fintech
Searching Database…

13.1K ·GitHub
Nofx
What is this?NOFX is an open-source, self-hosted AI trading terminal where a language model acts as the trading strategy, automatically trading crypto, US stocks, commodities and forex while a Go runtime enforces hard risk limits the model cannot override.
Is this a cloud service, or something I run on my own machine?It is self-hosted software that you run on your own computer or server; everything, including your exchange credentials, stays local to that machine.
How do I get it running?Install it on Linux/macOS with the provided install script (or deploy via Railway or Docker, Docker Desktop on Windows), register the first account as owner, then follow the guided launch: fund the AI fee wallet with $1+ USDC on Base, connect an exchange like Hyperliquid, deposit $12+ USDC, and start Autopilot.
Do I need my own AI model API keys to run it?You can bring your own keys for DeepSeek, OpenAI, Claude, Qwen, Gemini, Grok, Kimi or MiniMax, or skip keys entirely and pay per call through Claw402, which meters usage in USDC over the x402 protocol using only a wallet on Base.
Does the AI trade with no safety net?No — every order passes through code-enforced limits the model cannot override, including position and leverage caps, automatic stop-loss/take-profit, drawdown auto-close, trade throttling, and a safe mode that blocks new entries after repeated model failures.
Where do my exchange credentials go?They are encrypted at rest and never leave your machine, since the whole system runs locally.
What does the AGPL-3.0 license mean for me?NOFX is free and open source under AGPL-3.0, but the project is explicit that automated trading carries real financial risk and AI-driven strategies can lose money.
What markets can NOFX actually trade?Crypto perpetuals across all nine supported exchanges (Binance, Bybit, OKX, Hyperliquid, Bitget, KuCoin, Gate, Aster, Lighter), plus on Hyperliquid it also trades tokenized US stocks, commodities, indices, FX and pre-IPO perps like TSLA, NVDA, GOLD and SPX.
Can I run multiple trading strategies at once?Yes, you can run several traders side by side with different models or strategies and compare their performance on a public leaderboard ranked by realized return.
Is there an audit trail for the AI's decisions?Every decision is stored with the model's full reasoning, so no position is taken without a recorded rationale.
Can I customize how a trader behaves?The Strategy Studio lets you set style presets, coin universes, indicators, leverage, entry confidence and custom prompts for each trader.
What are similar projects?QuantDinger, hummingbot, astra-quant-agent, XChange, openclaw-zero-token, StockSharp, Trpjan-solana-trading-toolkit, TradingAgents-CN
Which topics is it in?x402, binance, exchange, forex, stocks, crypto-trading, bitcoin, minimax, kimi, fintech, trading, grok
Creator
NoFxAiOS
Size
70.7 MB
Stars
13.1K
Updated
CommitOct 18
Age
11mo
Commits · 90 Days