nofx/README.md
deanokk 1ba50bdedf
docs(readme): add quick demo video to localized READMEs (#1486)
* docs(README): add quick demo section with video link and image

* docs(README): update demo video link

* docs(i18n): add quick demo section with video link and image for multiple languages

---------

Co-authored-by: Dean <afei.wuhao@gmail.com>
2026-04-19 18:07:59 +08:00

19 KiB

NOFX

Your personal AI trading assistant.
Any market. Any model. Pay with USDC, not API keys.

Stars Release License Telegram

Go React x402 Claw402

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


NOFX is an open-source autonomous AI trading assistant. Unlike traditional AI tools that require you to manually configure models, manage API keys, and wire up data sources — NOFX's AI perceives markets, selects models, and fetches data entirely on its own. Zero human intervention. You set the strategy, the AI handles everything else.

Fully autonomous: The AI decides which model to use, what market data to pull, when to trade — all by itself. No manual model configuration. No juggling API keys for different services. Just fund a USDC wallet and let it run.

What makes it different: built-in x402 micropayments. No API keys. Fund a USDC wallet and pay per request. Your wallet is your identity.

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

Open http://127.0.0.1:3000. Done.


Quick Demo

NOFX quick demo video

Click the cover image to watch the demo video.


How x402 Works

Traditional flow: register account → buy credits → get API key → manage quota → rotate keys.

x402 flow:

Request → 402 (here's the price) → wallet signs USDC → retry → done

No accounts. No API keys. No prepaid credits. One wallet, every model.

Built-in x402 Providers

Provider Chain Models
Claw402 Base GPT-5.4, Claude Opus, DeepSeek, Qwen, Grok, Gemini, Kimi — 15+ models

What It Does

Feature Description
Multi-AI DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi, MiniMax — switch anytime
Multi-Exchange Binance, Bybit, OKX, Bitget, KuCoin, Gate, Hyperliquid, Aster, Lighter
Strategy Studio Visual builder — coin sources, indicators, risk controls
AI Competition AIs compete in real-time, leaderboard ranks performance
Telegram Agent Chat with your trading assistant — streaming, tool calling, memory
Dashboard Live positions, P/L, AI decision logs with Chain of Thought

Markets

Crypto · US Stocks · Forex · Metals

Exchanges (CEX)

Exchange Status Register (Fee Discount)
Binance ✅ Register
Bybit ✅ Register
OKX ✅ Register
Bitget ✅ Register
KuCoin ✅ Register
Gate ✅ Register

Exchanges (Perp-DEX)

Exchange Status Register (Fee Discount)
Hyperliquid ✅ Register
Aster DEX ✅ Register
Lighter ✅ Register

AI Models (API Key Mode)

AI Model Status Get API Key
DeepSeek ✅ Get API Key
Qwen ✅ Get API Key
OpenAI (GPT) ✅ Get API Key
Claude ✅ Get API Key
Gemini ✅ Get API Key
Grok ✅ Get API Key
Kimi ✅ Get API Key
MiniMax ✅ Get API Key

AI Models (x402 Mode — No API Key)

15+ models via Claw402 — just a USDC wallet


Screenshots

Config Page
AI Models & Exchanges Traders List
Dashboard
Overview Market Chart
Trading Stats Position History
Positions Trader Details
Strategy Studio
Strategy Editor Indicators Config
Competition
Competition Mode

Install

Linux / macOS

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

Railway (Cloud)

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

# 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

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

Setup

Beginner mode: First-time users get a guided onboarding flow — select beginner mode at registration and the system walks you through AI, exchange, and strategy setup step by step.

Advanced mode:

  1. AI — Add API keys or configure x402 wallet
  2. Exchange — Connect exchange API credentials
  3. Strategy — Build in Strategy Studio
  4. Trader — Combine AI + Exchange + Strategy
  5. Trade — Launch from the dashboard

Everything through the web UI at http://127.0.0.1:3000.


Deploy to Server

HTTP (quick):

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

HTTPS (Cloudflare):

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

Architecture

                              NOFX
    ┌─────────────────────────────────────────────────┐
    │                 Web Dashboard                     │
    │           React + TypeScript + TradingView        │
    ├─────────────────────────────────────────────────┤
    │                  API Server (Go)                  │
    ├──────────┬──────────┬──────────┬────────────────┤
    │  Strategy  │      Telegram       │
    │   Engine   │       Agent         │
    ├──────────┴──────────┴──────────┴────────────────┤
    │               MCP AI Client Layer                │
    │    ┌───────────┐  ┌───────────┐  ┌───────────┐  │
    │    │  API Key   │  │   x402    │  │           │  │
    │    │ DeepSeek   │  │ Claw402   │  │           │  │
    │    │ GPT,Claude │  │           │  │           │  │
    │    └───────────┘  └───────────┘  └───────────┘  │
    ├─────────────────────────────────────────────────┤
    │             Exchange Connectors                   │
    │  Binance · Bybit · OKX · Bitget · KuCoin · Gate  │
    │      Hyperliquid · Aster DEX · Lighter            │
    └─────────────────────────────────────────────────┘

Docs

Architecture System design and module index
Strategy Module Coin selection, AI prompts, execution
FAQ Common questions
Getting Started Deployment guide

Contributing

See Contributing Guide · Code of Conduct · Security Policy

Contributor Airdrop Program

All contributions are tracked. When NOFX generates revenue, contributors receive airdrops.

Pinned Issues get the highest rewards.

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

Website nofxai.com
Dashboard nofxos.ai/dashboard
API Docs nofxos.ai/api-docs
Telegram nofx_dev_community
Twitter @nofx_official

Risk Warning: AI auto-trading carries significant risks. Recommended for learning/research or small amounts only.


Sponsors

Become a sponsor

License

AGPL-3.0

Star History Chart