Back to Nofx

README

README.md

latest15.6 KB
Original Source
<h1 align="center">NOFX</h1> <p align="center"> <strong>Your personal AI trading assistant.</strong>

<strong>Any market. Any model. Pay with USDC, not API keys.</strong>

</p> <p align="center"> <a href="https://github.com/NoFxAiOS/nofx/stargazers"></a> <a href="https://github.com/NoFxAiOS/nofx/releases"></a> <a href="https://github.com/NoFxAiOS/nofx/blob/main/LICENSE"></a> <a href="https://t.me/nofx_dev_community"></a> </p> <p align="center"> <a href="https://golang.org/"></a> <a href="https://reactjs.org/"></a> <a href="https://x402.org"></a> <a href="https://claw402.ai"></a> <a href="https://blockrun.ai"></a> </p> <p align="center"> <a href="README.md">English</a> · <a href="docs/i18n/zh-CN/README.md">中文</a> · <a href="docs/i18n/ja/README.md">日本語</a> · <a href="docs/i18n/ko/README.md">한국어</a> · <a href="docs/i18n/ru/README.md">Русский</a> · <a href="docs/i18n/uk/README.md">Українська</a> · <a href="docs/i18n/vi/README.md">Tiếng Việt</a> </p>

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.

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

Open http://127.0.0.1:3000. Done.


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

ProviderChainModels
Claw402BaseGPT-5.4, Claude Opus, DeepSeek, Qwen, Grok, Gemini, Kimi — 15+ models
BlockRunBaseConfigurable
BlockRun SolSolanaConfigurable

Also compatible with ClawRouter — an intelligent LLM router that picks the cheapest capable model per request (41+ models, 74-100% savings, <1ms routing).


What It Does

FeatureDescription
Multi-AIDeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi — switch anytime
Multi-ExchangeBinance, Bybit, OKX, Bitget, KuCoin, Gate, Hyperliquid, Aster, Lighter
Strategy StudioVisual builder — coin sources, indicators, risk controls
AI CompetitionAIs compete in real-time, leaderboard ranks performance
Telegram AgentChat with your trading assistant — streaming, tool calling, memory
DashboardLive positions, P/L, AI decision logs with Chain of Thought

Markets

Crypto · US Stocks · Forex · Metals

Exchanges (CEX)

ExchangeStatusRegister (Fee Discount)
BinanceRegister
BybitRegister
OKXRegister
BitgetRegister
KuCoinRegister
GateRegister

Exchanges (Perp-DEX)

ExchangeStatusRegister (Fee Discount)
HyperliquidRegister
Aster DEXRegister
LighterRegister

AI Models (API Key Mode)

AI ModelStatusGet API Key
DeepSeekGet API Key
QwenGet API Key
OpenAI (GPT)Get API Key
ClaudeGet API Key
GeminiGet API Key
GrokGet API Key
KimiGet API Key

AI Models (x402 Mode — No API Key)

15+ models via Claw402 or BlockRun — just a USDC wallet


Screenshots

<details> <summary><b>Config Page</b></summary>
AI Models & ExchangesTraders List
</details> <details> <summary><b>Dashboard</b></summary>
OverviewMarket Chart
Trading StatsPosition History
PositionsTrader Details
</details> <details> <summary><b>Strategy Studio</b></summary>
Strategy EditorIndicators Config
</details> <details> <summary><b>Competition</b></summary>
Competition Mode
</details>

Install

Linux / macOS

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

Railway (Cloud)

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, 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

  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):

bash
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    │  │ ClawRouter│  │
    │    │ DeepSeek   │  │ Claw402   │  │ 41+ models│  │
    │    │ GPT,Claude │  │ BlockRun  │  │ auto-route│  │
    │    └───────────┘  └───────────┘  └───────────┘  │
    ├─────────────────────────────────────────────────┤
    │             Exchange Connectors                   │
    │  Binance · Bybit · OKX · Bitget · KuCoin · Gate  │
    │      Hyperliquid · Aster DEX · Lighter            │
    └─────────────────────────────────────────────────┘

Docs

ArchitectureSystem design and module index
Strategy ModuleCoin selection, AI prompts, execution
FAQCommon questions
Getting StartedDeployment 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.

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

Websitenofxai.com
Dashboardnofxos.ai/dashboard
API Docsnofxos.ai/api-docs
Telegramnofx_dev_community
Twitter@nofx_official

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


Sponsors

<a href="https://github.com/pjl914335852-ux"></a> <a href="https://github.com/cat9999aaa"></a> <a href="https://github.com/1733055465"></a> <a href="https://github.com/kolal2020"></a> <a href="https://github.com/CyberFFarm"></a> <a href="https://github.com/vip3001003"></a> <a href="https://github.com/mrtluh"></a> <a href="https://github.com/cpcp1117-source"></a> <a href="https://github.com/match-007"></a> <a href="https://github.com/leiwuhen1715"></a> <a href="https://github.com/SHAOXIA1991"></a>

Become a sponsor

License

AGPL-3.0