NOFX -- Open Source AI Trading OS
The infrastructure layer for AI-powered financial trading.
| CONTRIBUTOR AIRDROP PROGRAM |
|---|
| Code * Bug Fixes * Issues - Airdrop |
| Learn More |
Languages: English | Zhong Wen | Ri Ben Yu | hangugeo | Russkii | Ukrayins'ka | Tieng Viet
Supported Markets
| Market | Trading | Status |
|---|---|---|
| Crypto | BTC, ETH, Altcoins | Supported |
| US Stocks | AAPL, TSLA, NVDA, etc. | Supported |
| Forex | EUR/USD, GBP/USD, etc. | Supported |
| Metals | Gold, Silver | Supported |
Core Features
- Multi-AI Support: Run DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi - switch models anytime
- Multi-Exchange: Trade on Binance, Bybit, OKX, Bitget, KuCoin, Gate, 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
- Tinkle - @Web3Tinkle
- Official Twitter - @nofx_official
Official Links
- Official Website: https://nofxai.com
- Data Dashboard: https://nofxos.ai/dashboard
- API Documentation: https://nofxos.ai/api-docs
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
Before You Begin
To use NOFX, you'll need:
- Exchange Account - Register on any supported exchange and create API credentials with trading permissions
- AI Model API Key - Get from any supported provider (DeepSeek recommended for cost-effectiveness)
Supported Exchanges
CEX (Centralized Exchanges)
| Exchange | Status | Register (Fee Discount) |
|---|---|---|
| Binance | Register | |
| Bybit | Register | |
| OKX | Register | |
| Bitget | Register | |
| KuCoin | Register | |
| Gate | Register |
Perp-DEX (Decentralized Perpetual Exchanges)
| Exchange | Status | Register (Fee Discount) |
|---|---|---|
| Hyperliquid | Register | |
| Aster DEX | Register | |
| Lighter | Register |
Supported AI Models
| 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 |
Screenshots
Config Page
| AI Models & Exchanges | Traders List |
|---|---|
Competition & Backtest
| Competition Mode | Backtest Lab |
|---|---|
Dashboard
| Overview | Market Chart |
|---|---|
| Trading Stats | Position History |
|---|---|
| Positions | Trader Details |
|---|---|
Strategy Studio
| Strategy Editor | Indicators Config |
|---|---|
Debate Arena
| AI Debate Session | Create Debate |
|---|---|
Quick Start
One-Click Install (Local/Server)
Linux / macOS:
That's it! Open http://127.0.0.1:3000 in your browser.
One-Click Cloud Deploy (Railway)
Deploy to Railway with one click - no server setup required:
After deployment, Railway will provide a public URL to access your NOFX instance.
Docker Compose (Manual)
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
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:
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)
# macOS
brew install ta-lib
# Ubuntu/Debian
sudo apt-get install libta-lib0-dev
Installation Steps
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 --installRestart 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
> ~/.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"># 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:
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:
When enabled, browser uses Web Crypto API to encrypt API keys before transmission. This requires:
https://- Any domain with SSLhttp://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)
- 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
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
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
Sponsors
Thanks to all our sponsors!