mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2026-07-06 04:20:59 +08:00
63ddeec7ba
- Update project description to reflect current AI trading platform - Rewrite Core Features with 6 key capabilities - Add complete deployment guide (Docker + manual installation) - Update all i18n versions (zh-CN, ja, ko, ru, uk, vi) - Remove outdated JSON config examples
NOFX - Agentic Trading OS
| CONTRIBUTOR AIRDROP PROGRAM |
|---|
| Code · Bug Fixes · Issues → Airdrop |
| Learn More |
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, Hyperliquid, Aster DEX, Lighter from one platform
- Strategy Studio: Visual strategy builder with coin sources, indicators, and risk controls
- 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
Competition Mode - Real-time AI Battle
Multi-AI leaderboard with real-time performance comparison
Dashboard - Market Chart View
Professional trading dashboard with TradingView-style charts
Strategy Studio
Strategy configuration with multiple data sources and AI test
Supported Exchanges
CEX (Centralized Exchanges)
| Exchange | Status | Register (Fee Discount) |
|---|---|---|
| Binance | ✅ Supported | Register |
| Bybit | ✅ Supported | Register |
| OKX | ✅ 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
Option 1: Docker Deployment (Recommended)
# Clone the repository
git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
# Start with Docker
chmod +x ./start.sh
./start.sh start --build
Access Web Interface: http://localhost:3000
# Management commands
./start.sh logs # View logs
./start.sh status # Check status
./start.sh stop # Stop services
./start.sh restart # Restart services
Option 2: Manual Installation
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://localhost:3000
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
API Endpoints
Trader Management
GET /api/traders # List all traders
POST /api/traders # Create new trader
DELETE /api/traders/:id # Delete trader
POST /api/traders/:id/start # Start trader
POST /api/traders/:id/stop # Stop trader
Strategy Management
GET /api/strategies # List all strategies
POST /api/strategies # Create new strategy
PUT /api/strategies/:id # Update strategy
DELETE /api/strategies/:id # Delete strategy
Trading Data
GET /api/status?trader_id=xxx # System status
GET /api/account?trader_id=xxx # Account info
GET /api/positions?trader_id=xxx # Position list
GET /api/decisions/latest?trader_id=xxx # Latest decisions
Risk Warnings
- Cryptocurrency markets are extremely volatile - AI decisions don't guarantee profit
- Futures trading uses leverage - losses may exceed principal
- Extreme market conditions may lead to liquidation risk
Recommendations:
- Use only funds you can afford to lose
- Start with small amounts (100-500 USDT)
- Regularly monitor system operation
- Don't run unsupervised for long periods
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
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