Skip to content

NoFxAiOS/nofx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

NOFX - Agentic Trading OS

Go Version React TypeScript License

CONTRIBUTOR AIRDROP PROGRAM
Code · Bug Fixes · Issues → Airdrop
Learn More

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


AI-Powered Crypto Trading Platform

NOFX is an open-source AI trading system that lets you run multiple AI models to trade crypto futures automatically. Configure strategies through a web interface, monitor performance in real-time, and let AI agents compete to find the best trading approach.

Core Features

  • Multi-AI Support: Run DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi - switch models anytime
  • Multi-Exchange: Trade on Binance, Bybit, OKX, Bitget, Hyperliquid, Aster DEX, Lighter from one platform
  • Strategy Studio: Visual strategy builder with coin sources, indicators, and risk controls
  • AI Debate Arena: Multiple AI models debate trading decisions with different roles (Bull, Bear, Analyst)
  • AI Competition Mode: Multiple AI traders compete in real-time, track performance side by side
  • Web-Based Config: No JSON editing - configure everything through the web interface
  • Real-Time Dashboard: Live positions, P/L tracking, AI decision logs with Chain of Thought

Core Team

Risk Warning: This system is experimental. AI auto-trading carries significant risks. Strongly recommended for learning/research purposes or testing with small amounts only!

Developer Community

Join our Telegram developer community: NOFX Developer Community


Screenshots

Config Page

AI Models & Exchanges Traders List
Config - AI Models & Exchanges Config - Traders List

Competition & Backtest

Competition Mode Backtest Lab
Competition Page Backtest Lab

Dashboard

Overview Market Chart
Dashboard Overview Dashboard Market Chart
Positions Trader Details
Dashboard Positions Trader Details

Strategy Studio

Strategy Editor Indicators Config
Strategy Studio Strategy Indicators

Debate Arena

AI Debate Session Create Debate
Debate Arena Create Debate

Supported Exchanges

CEX (Centralized Exchanges)

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

Perp-DEX (Decentralized Perpetual Exchanges)

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

Supported AI Models

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

Quick Start

One-Click Install (Recommended)

Linux / macOS:

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

That's it! Open http://127.0.0.1:3000 in your browser.

Docker Compose (Manual)

# Download and start
curl -O https://raw.githubusercontent.com/NoFxAiOS/nofx/main/docker-compose.prod.yml
docker compose -f docker-compose.prod.yml up -d

Access Web Interface: http://127.0.0.1:3000

# Management commands
docker compose -f docker-compose.prod.yml logs -f    # View logs
docker compose -f docker-compose.prod.yml restart    # Restart
docker compose -f docker-compose.prod.yml down       # Stop
docker compose -f docker-compose.prod.yml pull && docker compose -f docker-compose.prod.yml up -d  # Update

Keeping Updated

💡 Updates are frequent. Run this command daily to stay current with the latest features and fixes:

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

This one-liner pulls the latest official images and restarts services automatically.

Manual Installation (For Developers)

Prerequisites

  • Go 1.21+
  • Node.js 18+
  • TA-Lib (technical indicator library)
# Install TA-Lib
# macOS
brew install ta-lib

# Ubuntu/Debian
sudo apt-get install libta-lib0-dev

Installation Steps

# 1. Clone the repository
git clone https://github.com/NoFxAiOS/nofx.git
cd nofx

# 2. Install backend dependencies
go mod download

# 3. Install frontend dependencies
cd web
npm install
cd ..

# 4. Build and start backend
go build -o nofx
./nofx

# 5. Start frontend (new terminal)
cd web
npm run dev

Access Web Interface: http://127.0.0.1:3000


Windows Installation

Method 1: Docker Desktop (Recommended)

  1. Install Docker Desktop

  2. Run NOFX

    # Open PowerShell and run:
    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
  3. Access: Open http://127.0.0.1:3000 in your browser

Method 2: WSL2 (For Development)

  1. Install WSL2

    # Open PowerShell as Administrator
    wsl --install

    Restart your computer after installation.

  2. Install Ubuntu from Microsoft Store

    • Open Microsoft Store
    • Search "Ubuntu 22.04" and install
    • Launch Ubuntu and set up username/password
  3. Install Dependencies in WSL2

    # Update system
    sudo apt update && sudo apt upgrade -y
    
    # Install Go
    wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
    sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz
    echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
    source ~/.bashrc
    
    # Install Node.js
    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
    sudo apt-get install -y nodejs
    
    # Install TA-Lib
    sudo apt-get install -y libta-lib0-dev
    
    # Install Git
    sudo apt-get install -y git
  4. Clone and Run NOFX

    git clone https://github.com/NoFxAiOS/nofx.git
    cd nofx
    
    # Build and run backend
    go build -o nofx && ./nofx
    
    # In another terminal, run frontend
    cd web && npm install && npm run dev
  5. Access: Open http://127.0.0.1:3000 in Windows browser

Method 3: Docker in WSL2 (Best of Both Worlds)

  1. Install Docker Desktop with WSL2 backend

    • During Docker Desktop installation, enable "Use WSL 2 based engine"
    • In Docker Desktop Settings → Resources → WSL Integration, enable your Linux distro
  2. Run from WSL2 terminal

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

Server Deployment

Quick Deploy (HTTP via IP)

By default, transport encryption is disabled, allowing you to access NOFX via IP address without HTTPS:

# Deploy to your server
curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash

Access via http://YOUR_SERVER_IP:3000 - works immediately.

Enhanced Security (HTTPS)

For enhanced security, enable transport encryption in .env:

TRANSPORT_ENCRYPTION=true

When enabled, browser uses Web Crypto API to encrypt API keys before transmission. This requires:

  • https:// - Any domain with SSL
  • http://localhost - Local development

Quick HTTPS Setup with Cloudflare

  1. Add your domain to Cloudflare (free plan works)

  2. Create DNS record

    • Type: A
    • Name: nofx (or your subdomain)
    • Content: Your server IP
    • Proxy status: Proxied (orange cloud)
  3. Configure SSL/TLS

    • Go to SSL/TLS settings
    • Set encryption mode to Flexible
    User ──[HTTPS]──→ Cloudflare ──[HTTP]──→ Your Server:3000
    
  4. Enable transport encryption

    # Edit .env and set
    TRANSPORT_ENCRYPTION=true
  5. Done! Access via https://nofx.yourdomain.com


Initial Setup (Web Interface)

After starting the system, configure through the web interface:

  1. Configure AI Models - Add your AI API keys (DeepSeek, OpenAI, etc.)
  2. Configure Exchanges - Set up exchange API credentials
  3. Create Strategy - Configure trading strategy in Strategy Studio
  4. Create Trader - Combine AI model + Exchange + Strategy
  5. Start Trading - Launch your configured traders

All configuration is done through the web interface - no JSON file editing required.


Web Interface Features

Competition Page

  • Real-time ROI leaderboard
  • Multi-AI performance comparison charts
  • Live P/L tracking and rankings

Dashboard

  • TradingView-style candlestick charts
  • Real-time position management
  • AI decision logs with Chain of Thought reasoning
  • Equity curve tracking

Strategy Studio

  • Coin source configuration (Static list, AI500 pool, OI Top)
  • Technical indicators (EMA, MACD, RSI, ATR, Volume, OI, Funding Rate)
  • Risk control settings (leverage, position limits, margin usage)
  • AI test with real-time prompt preview

Debate Arena

  • Multi-AI debate sessions for trading decisions
  • Configurable AI roles (Bull, Bear, Analyst, Contrarian, Risk Manager)
  • Multiple rounds of debate with consensus voting
  • Auto-execute consensus trades

Backtest Lab

  • 3-step wizard configuration (Model → Parameters → Confirm)
  • Real-time progress visualization with animated ring
  • Equity curve chart with trade markers
  • Trade timeline with card-style display
  • Performance metrics (Return, Max DD, Sharpe, Win Rate)
  • AI decision trail with Chain of Thought

Common Issues

TA-Lib not found

# macOS
brew install ta-lib

# Ubuntu
sudo apt-get install libta-lib0-dev

AI API timeout

  • Check if API key is correct
  • Check network connection
  • System timeout is 120 seconds

Frontend can't connect to backend


Documentation

Document Description
Architecture Overview System design and module index
Strategy Module Coin selection, data assembly, AI prompts, execution
Backtest Module Historical simulation, metrics, checkpoint/resume
Debate Module Multi-AI debate, voting consensus, auto-execution
FAQ Frequently asked questions
Getting Started Deployment guide

License

This project is licensed under GNU Affero General Public License v3.0 (AGPL-3.0) - See LICENSE file.


Contributing

We welcome contributions! See:


Contributor Airdrop Program

All contributions are tracked on GitHub. When NOFX generates revenue, contributors will receive airdrops based on their contributions.

PRs that resolve Pinned Issues receive the HIGHEST rewards!

Contribution Type Weight
Pinned Issue PRs ⭐⭐⭐⭐⭐⭐
Code Commits (Merged PRs) ⭐⭐⭐⭐⭐
Bug Fixes ⭐⭐⭐⭐
Feature Suggestions ⭐⭐⭐
Bug Reports ⭐⭐
Documentation ⭐⭐

Contact


Star History

Star History Chart

About

Open-source Trading OS with pluggable AI brain | From market data → AI reasoning → Trade execution | Self-hosted & Multi-exchange

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages