| CONTRIBUTOR AIRDROP PROGRAM |
|---|
| Code · Bug Fixes · Issues → Airdrop |
| Learn More |
Languages: English | 中文 | 日本語 | 한국어 | Русский | Українська | Tiếng Việt
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.
- 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
- 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!
Join our Telegram developer community: NOFX Developer Community
| AI Models & Exchanges | Traders List |
|---|---|
| Competition Mode | Backtest Lab |
|---|---|
| Overview | Market Chart |
|---|---|
| Positions | Trader Details |
|---|---|
| Strategy Editor | Indicators Config |
|---|---|
| AI Debate Session | Create Debate |
|---|---|
| Exchange | Status | Register (Fee Discount) |
|---|---|---|
| Binance | ✅ Supported | Register |
| Bybit | ✅ Supported | Register |
| OKX | ✅ Supported | Register |
| Bitget | ✅ Supported | Register |
| Exchange | Status | Register (Fee Discount) |
|---|---|---|
| Hyperliquid | ✅ Supported | Register |
| Aster DEX | ✅ Supported | Register |
| Lighter | ✅ Supported | Register |
| 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 |
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bashThat's it! Open http://127.0.0.1:3000 in your browser.
# Download and start
curl -O https://raw.githubusercontent.com/NoFxAiOS/nofx/main/docker-compose.prod.yml
docker compose -f docker-compose.prod.yml up -dAccess 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💡 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 | bashThis one-liner pulls the latest official images and restarts services automatically.
- 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# 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 devAccess Web Interface: http://127.0.0.1:3000
-
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
-
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
-
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
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 | bashAccess via http://YOUR_SERVER_IP:3000 - works immediately.
For enhanced security, enable transport encryption in .env:
TRANSPORT_ENCRYPTION=trueWhen enabled, browser uses Web Crypto API to encrypt API keys before transmission. This requires:
https://- Any domain with SSLhttp://localhost- Local development
-
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)
- Type:
-
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
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.
- Real-time ROI leaderboard
- Multi-AI performance comparison charts
- Live P/L tracking and rankings
- TradingView-style candlestick charts
- Real-time position management
- AI decision logs with Chain of Thought reasoning
- Equity curve tracking
- 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
- 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
- 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
# macOS
brew install ta-lib
# Ubuntu
sudo apt-get install libta-lib0-dev- Check if API key is correct
- Check network connection
- System timeout is 120 seconds
- Ensure backend is running on http://localhost:8080
- Check if port is occupied
| 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 |
This project is licensed under GNU Affero General Public License v3.0 (AGPL-3.0) - See LICENSE file.
We welcome contributions! See:
- Contributing Guide - Development workflow and PR process
- Code of Conduct - Community guidelines
- Security Policy - Report vulnerabilities
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 | ⭐⭐ |
- GitHub Issues: Submit an Issue
- Developer Community: Telegram Group