NOFX – Agentic Trading OS

Test3
Tag3

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

Backed by Amber.ac

Core Team

Tinkle – @Web3Tinkle
Official Twitter – @nofx_official

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

Competition & Backtest

Dashboard

Strategy Studio

Debate Arena

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

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)

Install Docker Desktop

Download from docker.com/products/docker-desktop
Run the installer and restart your computer
Start Docker Desktop and wait for it to be ready

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

Access: Open http://127.0.0.1:3000 in your browser

Method 2: WSL2 (For Development)

Install WSL2

   # Open PowerShell as Administrator
   wsl --install

Restart your computer after installation.

Install Ubuntu from Microsoft Store

Open Microsoft Store
Search “Ubuntu 22.04” and install
Launch Ubuntu and set up username/password

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

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

Access: Open http://127.0.0.1:3000 in Windows browser

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

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

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

Add your domain to Cloudflare (free plan works)

Go to dash.cloudflare.com
Add your domain and update nameservers

Create DNS record

Type: A
Name: nofx (or your subdomain)
Content: Your server IP
Proxy status: Proxied (orange cloud)

Configure SSL/TLS

Go to SSL/TLS settings
Set encryption mode to Flexible

   User ──[HTTPS]──→ Cloudflare ──[HTTP]──→ Your Server:3000

Enable transport encryption

   # Edit .env and set
   TRANSPORT_ENCRYPTION=true

Done! Access via https://nofx.yourdomain.com

Initial Setup (Web Interface)

After starting the system, configure through the web interface:

Configure AI Models – Add your AI API keys (DeepSeek, OpenAI, etc.)
Configure Exchanges – Set up exchange API credentials
Create Strategy – Configure trading strategy in Strategy Studio
Create Trader – Combine AI model + Exchange + Strategy
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

Ensure backend is running on http://localhost:8080
Check if port is occupied

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:

Contributing Guide – Development workflow and PR process
Code of Conduct – Community guidelines
Security Policy – Report vulnerabilities

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

GitHub Issues: Submit an Issue
Developer Community: Telegram Group

Star History

Test3
Tag3