----
+
-NOFX is an open-source AI trading terminal for active traders who want one workspace for market research, strategy development, execution, and portfolio monitoring.
+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.
-The product is built around global liquid markets: US equities, commodity contracts, FX pairs, and digital assets. The AI layer helps translate market intent into watchlists, signals, strategy logic, risk controls, and execution workflows.
+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.
```bash
curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
```
-Open **http://127.0.0.1:3000**.
+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
-Use the links below to open trading accounts for crypto and supported US stock, FX, and commodity derivative markets. These routes are part of NOFX partner programs and may include fee discounts or referral benefits.
+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 |
| :---------------------------------------------------------------------------------------------------------------------------- | :----: | :---------------------------------------------------------------------------------- |
@@ -59,59 +57,47 @@ Use the links below to open trading accounts for crypto and supported US stock,
| **Aster** | ✅ | [Register](https://www.asterdex.com/en/referral/fdfc0e) |
| **Lighter** | ✅ | [Register](https://app.lighter.xyz/?referral=68151432) |
----
+
-## Quick demo
+## Demo
https://github.com/user-attachments/assets/3310f495-14c5-4586-a1cc-3d32e44aa505
----
+
-## Markets
+## The model proposes. The runtime disposes.
-**US Stocks · Commodities · Forex · Crypto**
+Decisions come from a language model reading live market structure — candles, EMA/MACD/RSI/ATR/Bollinger, open interest, net flow, signal rankings. Execution does not.
-NOFX organizes research, strategy construction, execution, and monitoring around multi-asset workflows instead of single-venue screens.
+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 |
-## AI model access
+Each decision is stored with the model's full reasoning. There is no position without a paper trail.
-NOFX routes AI inference through [Claw402](https://claw402.ai) automatically. Users do not need to configure model providers, manage API keys, or maintain separate AI accounts. The terminal accesses supported models on demand through Claw402's pay-as-you-go infrastructure, with traffic routed through the official discounted channel.
+
-| Provider | Access |
-| :------- | :----- |
-| **Claw402** | [Access pay-as-you-go AI models with official discount](https://claw402.ai) |
+## Terminal
----
-
-## Capabilities
-
-| Capability | Description |
-| :-------------------------- | :-------------------------------------------------------------------------- |
-| **AI trading terminal** | Unified workspace for US stocks, commodities, forex, and crypto workflows |
-| **AI model access** | Unified model access through Claw402-supported providers |
-| **Exchange connectivity** | Binance, Bybit, OKX, Hyperliquid, Bitget, KuCoin, Gate, Aster, and Lighter |
-| **Strategy Studio** | Market universes, indicators, risk controls, and strategy logic |
-| **Model competition** | Compare model-driven traders with live performance and leaderboard tracking |
-| **Telegram agent** | Control and monitor the trading assistant through chat |
-| **Portfolio dashboard** | Positions, P/L, execution history, and model decision logs |
-
----
-
-## Screenshots
+| | |
+| :--- | :--- |
+| **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 |
-Config Page
+Screenshots
-| Configuration | Traders List |
-| :----------------------------------------------------------: | :----------------------------------------------------------: |
-| | |
-
-
-
-
-Dashboard
+
| Overview | Market Chart |
| :-----------------------------------------------------: | :-------------------------------------------------------------: |
@@ -121,131 +107,51 @@ NOFX routes AI inference through [Claw402](https://claw402.ai) automatically. Us
| :--------------------------------------------------------------: | :-----------------------------------------------------------------: |
| | |
-| Positions | Trader Details |
-| :----------------------------------------------------------: | :---------------------------------------------------: |
-| | |
-
-
-
-
-Strategy Studio
-
| Strategy Editor | Indicators Config |
| :------------------------------------------------------: | :----------------------------------------------------------: |
| | |
-
-
-
-Competition
-
-| Competition Mode |
-| :-------------------------------------------------------: |
-| |
+| Competition | Configuration |
+| :-------------------------------------------------------: | :-----------------------------------------------------------: |
+| | |
----
+
-## Install
+## Models
-### Linux / macOS
+Eight providers with your own keys — DeepSeek, OpenAI, Claude, Qwen, Gemini, Grok, Kimi, MiniMax — including custom endpoints and model names.
-```bash
-curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
-```
+Or no keys at all: [Claw402](https://claw402.ai) meters model usage per call in USDC over the x402 protocol. A wallet on Base replaces every API key.
-### Railway (Cloud)
+| Provider | Access |
+| :------- | :----- |
+| **Claw402** | [Pay-as-you-go AI models with official discount](https://claw402.ai) |
-[](https://railway.com/deploy/nofx?referralCode=nofx)
+## Markets
-### Docker
+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.
-```bash
-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](https://www.docker.com/products/docker-desktop/), then:
-
-```powershell
-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
-
-```bash
-# Prerequisites: Go 1.21+, Node.js 18+, TA-Lib
-# macOS: brew install ta-lib
-# Ubuntu: sudo apt-get install libta-lib0-dev
-
-git clone https://github.com/NoFxAiOS/nofx.git && cd nofx
-go build -o nofx && ./nofx # backend
-cd web && npm install && npm run dev # frontend (new terminal)
-```
-
-### Update
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
-```
-
----
-
-## Setup
-
-**Beginner mode**: Guided onboarding walks new users through model selection, exchange connection, strategy setup, and first deployment.
-
-**Advanced mode**:
-
-1. Configure AI model access
-2. Connect exchange credentials
-3. Build or import a strategy
-4. Create an AI trader profile
-5. Launch, monitor, and iterate from the dashboard
-
-All configuration is available from the web UI at **http://127.0.0.1:3000**.
-
----
-
-## Deploy to server
-
-**HTTP deployment:**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
-# Access via http://YOUR_IP:3000
-```
-
-**HTTPS via Cloudflare:**
-
-1. Add domain to [Cloudflare](https://dash.cloudflare.com) (free plan)
-2. A record → your server IP (Proxied)
-3. SSL/TLS → Flexible
-4. Set `TRANSPORT_ENCRYPTION=true` in `.env`
-
----
+
## Architecture
```
- NOFX
┌─────────────────────────────────────────────────┐
│ Trading Terminal │
- │ React + TypeScript + TradingView │
- │ US Stocks · Commodities · Forex · Crypto │
+ │ React · TypeScript · TradingView │
+ │ Dashboard · Strategy Studio · Competition │
├─────────────────────────────────────────────────┤
│ API Server (Go) │
+ │ JWT auth · encrypted credential store │
├──────────────┬──────────────┬───────────────────┤
- │ Strategy │ Telegram │ Trader Runtime │
- │ Engine │ Agent │ Risk Controls │
+ │ Strategy │ Autopilot │ Trader Runtime │
+ │ Engine │ Preflight │ Risk Engine │
├──────────────┴──────────────┴───────────────────┤
│ AI Model Layer │
- │ Unified provider access through Claw402 │
- │ Model routing · payment · execution support │
+ │ DeepSeek · OpenAI · Claude · Qwen · Gemini │
+ │ Grok · Kimi · MiniMax · Claw402 (x402 USDC) │
├─────────────────────────────────────────────────┤
│ Exchange Connectivity │
│ Binance · Bybit · OKX · Hyperliquid · Bitget │
@@ -253,26 +159,86 @@ curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bas
└─────────────────────────────────────────────────┘
```
----
+
-## Docs
+## Install
+
+**Linux / macOS**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash
+```
+
+**Railway**
+
+[](https://railway.com/deploy/nofx?referralCode=nofx)
+
+**Docker**
+
+```bash
+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](https://www.docker.com/products/docker-desktop/), then:
+
+```powershell
+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+:
+
+```bash
+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**
+
+```bash
+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](https://dash.cloudflare.com) (free plan)
+2. A record → server IP, proxied
+3. SSL/TLS → Flexible
+4. `TRANSPORT_ENCRYPTION=true` in `.env`
+
+
+
+
+
+## Documentation
| | |
| :------------------------------------------------------ | :------------------------------------ |
+| [Getting Started](docs/getting-started/README.md) | Deployment and exchange API guides |
| [Architecture](docs/architecture/README.md) | System design and module index |
| [Strategy Module](docs/architecture/STRATEGY_MODULE.md) | Coin selection, AI prompts, execution |
-| [FAQ](docs/faq/README.md) | Common questions |
-| [Getting Started](docs/getting-started/README.md) | Deployment guide |
+| [FAQ](docs/guides/faq.en.md) | Common questions |
+| [Troubleshooting](docs/guides/TROUBLESHOOTING.md) | Diagnosing common issues |
----
+## Community
+
+[Telegram](https://t.me/nofx_dev_community) · [Twitter/X](https://x.com/vergex_ai) · [Issues](https://github.com/NoFxAiOS/nofx/issues) · [vergex.trade](https://vergex.trade) · [Live dashboard](https://vergex.trade/explore)
## Contributing
-See [Contributing Guide](CONTRIBUTING.md), [Code of Conduct](CODE_OF_CONDUCT.md), and [Security Policy](SECURITY.md).
+Code, documentation, translations, and bug reports are all welcome — see the [Contributing Guide](CONTRIBUTING.md), [Code of Conduct](CODE_OF_CONDUCT.md), and [Security Policy](SECURITY.md).
-### Contributor Airdrop Program
-
-NOFX tracks meaningful contributions and intends to reward contributors as the ecosystem grows. Priority issues carry higher reward weight.
+NOFX tracks meaningful contributions and intends to reward contributors as the ecosystem grows. Priority issues carry higher weight.
| Contribution | Weight |
| :---------------- | :----: |
@@ -283,20 +249,9 @@ NOFX tracks meaningful contributions and intends to reward contributors as the e
| Bug Reports | ★★ |
| Documentation | ★★ |
----
-
-## Links
-
-| | |
-| :-------- | :---------------------------------------------------- |
-| Website | [vergex.trade](https://vergex.trade) |
-| Dashboard | [vergex.trade/explore](https://vergex.trade/explore) |
-| Telegram | [nofx_dev_community](https://t.me/nofx_dev_community) |
-| Twitter | [@vergex_ai](https://x.com/vergex_ai) |
-
-> **Risk warning**: Automated trading involves substantial risk. Use appropriate position sizing, understand each exchange venue, and do not trade funds you cannot afford to lose.
-
----
+
+
+
## Sponsors
@@ -314,8 +269,14 @@ NOFX tracks meaningful contributions and intends to reward contributors as the e
[Become a sponsor](https://github.com/sponsors/NoFxAiOS)
+
+
+If NOFX is useful to you, a star helps other traders find it.
+
+[](https://star-history.com/#NoFxAiOS/nofx&Date)
+
## License
[AGPL-3.0](LICENSE)
-[](https://star-history.com/#NoFxAiOS/nofx&Date)
+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](DISCLAIMER.md).
diff --git a/docs/assets/nofx-banner.svg b/docs/assets/nofx-banner.svg
new file mode 100644
index 00000000..8e36e8d5
--- /dev/null
+++ b/docs/assets/nofx-banner.svg
@@ -0,0 +1,44 @@
+
diff --git a/web/src/components/landing/AboutSection.tsx b/web/src/components/landing/AboutSection.tsx
deleted file mode 100644
index 17d34c67..00000000
--- a/web/src/components/landing/AboutSection.tsx
+++ /dev/null
@@ -1,157 +0,0 @@
-import { motion } from 'framer-motion'
-import { Terminal, Shield, Cpu, BarChart3 } from 'lucide-react'
-import { t, Language } from '../../i18n/translations'
-
-interface AboutSectionProps {
- language: Language
-}
-
-export default function AboutSection({ language }: AboutSectionProps) {
- const features = [
- {
- icon: Shield,
- title: language === 'zh' ? 'Full Control' : 'Full Control',
- desc: language === 'zh' ? 'Self-hosted, data secure' : 'Self-hosted, data secure',
- },
- {
- icon: Cpu,
- title: language === 'zh' ? 'Multi-AI Support' : 'Multi-AI Support',
- desc: language === 'zh' ? 'DeepSeek, GPT, Claude...' : 'DeepSeek, GPT, Claude...',
- },
- {
- icon: BarChart3,
- title: language === 'zh' ? 'Real-time Monitor' : 'Real-time Monitor',
- desc: language === 'zh' ? 'Visual trading dashboard' : 'Visual trading dashboard',
- },
- ]
-
- return (
-
- {/* Background Decoration */}
-
-
-
-
- )
-}
diff --git a/web/src/components/landing/FeaturesSection.tsx b/web/src/components/landing/FeaturesSection.tsx
deleted file mode 100644
index bc26112a..00000000
--- a/web/src/components/landing/FeaturesSection.tsx
+++ /dev/null
@@ -1,203 +0,0 @@
-import { motion } from 'framer-motion'
-import { Brain, Swords, BarChart3, Shield, Blocks, LineChart } from 'lucide-react'
-import { t, Language } from '../../i18n/translations'
-
-interface FeaturesSectionProps {
- language: Language
-}
-
-export default function FeaturesSection({ language }: FeaturesSectionProps) {
- const features = [
- {
- icon: Brain,
- title: language === 'zh' ? 'AI Strategy Orchestration' : 'AI Strategy Orchestration',
- desc: language === 'zh'
- ? 'Support DeepSeek, GPT, Claude, Qwen and more. Custom prompts, AI autonomously analyzes markets and makes trading decisions'
- : 'Support DeepSeek, GPT, Claude, Qwen and more. Custom prompts, AI autonomously analyzes markets and makes trading decisions',
- highlight: true,
- badge: language === 'zh' ? 'Core' : 'Core',
- },
- {
- icon: Swords,
- title: language === 'zh' ? 'Multi-AI Arena' : 'Multi-AI Arena',
- desc: language === 'zh'
- ? 'Multiple AI traders compete in real-time, live PnL leaderboard, automatic survival of the fittest'
- : 'Multiple AI traders compete in real-time, live PnL leaderboard, automatic survival of the fittest',
- highlight: true,
- badge: language === 'zh' ? 'Unique' : 'Unique',
- },
- {
- icon: LineChart,
- title: language === 'zh' ? 'Pro Quant Data' : 'Pro Quant Data',
- desc: language === 'zh'
- ? 'Integrated candlesticks, indicators, order book, funding rates, open interest - comprehensive data for AI decisions'
- : 'Integrated candlesticks, indicators, order book, funding rates, open interest - comprehensive data for AI decisions',
- highlight: true,
- badge: language === 'zh' ? 'Pro' : 'Pro',
- },
- {
- icon: Blocks,
- title: language === 'zh' ? 'Multi-Exchange Support' : 'Multi-Exchange Support',
- desc: language === 'zh'
- ? 'Binance, OKX, Bybit, Hyperliquid, Aster DEX - one system, multiple exchanges'
- : 'Binance, OKX, Bybit, Hyperliquid, Aster DEX - one system, multiple exchanges',
- },
- {
- icon: BarChart3,
- title: language === 'zh' ? 'Real-time Dashboard' : 'Real-time Dashboard',
- desc: language === 'zh'
- ? 'Trade monitoring, PnL curves, position analysis, AI decision logs at a glance'
- : 'Trade monitoring, PnL curves, position analysis, AI decision logs at a glance',
- },
- {
- icon: Shield,
- title: language === 'zh' ? 'Open Source & Self-Hosted' : 'Open Source & Self-Hosted',
- desc: language === 'zh'
- ? 'Fully open source, data stored locally, API keys never leave your server'
- : 'Fully open source, data stored locally, API keys never leave your server',
- },
- ]
-
- return (
-
- {/* Background */}
-
-
-
- {/* Header */}
-
-
- {t('whyChooseNofx', language)}
-
-
- {language === 'zh'
- ? 'Not just a trading bot, but a complete AI trading operating system'
- : 'Not just a trading bot, but a complete AI trading operating system'}
-
- Initialize your own high-frequency trading node in seconds.
- Our optimized installer handles all dependencies, bringing the trading system online with a single command.
+ One command on your laptop or any server installs
+ everything. Open the address it prints, create your
+ account, and the guided launch takes you to your
+ first AI trade in about five minutes — around $13
+ is enough to start.
+ {/* the first five minutes, in plain words */}
+
+ {[
+ 'Register — the first account owns this instance.',
+ 'Fund two small wallets: $1+ for AI fees, $12+ to trade with (guided, with QR codes).',
+ 'Press Start — the AI trades on its own; stop it anytime.',
+ ].map((step, i) => (
+
+ {/* Newcomers see the guided launch FIRST — the config grid is detail.
+ Once an autopilot is running, the running bot takes back the top. */}
+ {!hasRunningTrader && launchPanel}
+
{/* Configuration Status Grid */}
-
+ {hasRunningTrader && launchPanel}
{/* Traders List */}
= [
{
- title: 'AI fee wallet',
+ title: 'Step 1 · Fund the AI wallet ($1+)',
detail:
- 'Pays Claw402.ai data and model calls with Base USDC. This is separate from trading collateral.',
+ 'The AI pays a tiny fee each time it thinks. Send $1 or more of USDC on the Base network to this address — from Binance, OKX, Coinbase or any wallet. Separate from your trading money.',
status: feeReady ? 'ready' : 'action',
meta: feeWalletAddress
? `${shortAddress(feeWalletAddress)} · ${formatUSDC(feeWalletBalance)} USDC${
feeReady ? '' : ` · needs ≥ ${minAIFeeUSDC} USDC`
}`
- : 'Base USDC wallet required',
+ : 'Takes 1 minute — we create the wallet for you',
action: feeWalletAddress ? (
- 
**Aster** | ✅ | [Register](https://www.asterdex.com/en/referral/fdfc0e) |
| 
**Lighter** | ✅ | [Register](https://app.lighter.xyz/?referral=68151432) |
----
+
| 
|
-
-
| 
|
-| Positions | Trader Details |
-| :----------------------------------------------------------: | :---------------------------------------------------: |
-| 
| 
|
-
-
| 
|
-
|
+| Competition | Configuration |
+| :-------------------------------------------------------: | :-----------------------------------------------------------: |
+|