🚀 Neural Trader by rUv - AI-Powered Trading Platform

Advanced Neural Trading System with 27 AI Models, 20 NPM Packages & 78.75x Performance Boost

NPM Packages (20 Published)

Performance & Features

A cutting-edge AI-powered trading platform featuring advanced neural strategies, real-time news sentiment analysis, comprehensive backtesting, and optional JWT authentication. Built with FastAPI and designed for both CPU and GPU environments.

🌐 Live API: https://neural-trader.ruv.io
📚 Documentation: https://neural-trader.ruv.io/docs

✨ Key Features

🧠 Neural Trading Strategies

• 8 Advanced Strategies: Mirror Trader, Momentum Trader, Enhanced Momentum, Neural Sentiment, Neural Arbitrage, Neural Trend, Mean Reversion, Pairs Trading
• GPU Acceleration Ready: Automatic detection and utilization when available
• Real-Time Execution: Sub-second decision making and order placement
• Multi-Symbol Support: Trade multiple assets simultaneously

📊 Comprehensive Trading Operations

• Live Trading: Start/stop trading with advanced configuration
• Backtesting: Historical performance analysis with Sharpe ratio calculations
• Strategy Optimization: Parameter tuning with up to 100 iterations
• Risk Management: Stop-loss, take-profit, and position sizing controls

🔐 Enterprise Security (NEW!)

• JWT Authentication: Optional Bearer token authentication
• API Key Support: Alternative authentication method
• Environment-Based Config: Secure secrets management
• Bcrypt Password Hashing: Industry-standard security

📈 Advanced Analytics

• AI News Sentiment: Real-time news analysis for trading signals
• Portfolio Analytics: Sharpe ratio, max drawdown, win rate metrics
• Risk Analysis: VaR, CVaR, and Monte Carlo simulations
• Performance Monitoring: Real-time tracking and Prometheus metrics

🚀 Production Ready

• FastAPI Framework: High-performance async API
• Docker Deployment: Containerized for easy deployment
• Fly.io Integration: One-command cloud deployment
• Health Monitoring: Built-in health checks and status endpoints

🔥 Quick Start

1. Clone the Repository

git clone https://github.com/yourusername/ai-news-trader.git
cd ai-news-trader

2. Install Dependencies

pip install -r requirements.txt

3. Configure Environment

cp .env.example .env
# Edit .env with your API keys and settings

4. Run Locally

python -m uvicorn src.main:app --reload --port 8080

5. Deploy to Production

# Using the deployment script
./scripts/deploy-to-fly.sh

# Or deploy with Docker (see Docker section below)

📦 NPM Packages

Neural Trader is available as 20 modular npm packages for Node.js integration with high-performance Rust bindings:

Core Packages

Package	Version	Description	Size	Install
@neural-trader/backend		Complete trading backend with 60+ functions	4.4 MB	npm i @neural-trader/backend
@neural-trader/core		Core utilities and shared types	-	npm i @neural-trader/core
@neural-trader/neural		27 neural forecasting models (78.75x speedup)	10.3 MB	npm i @neural-trader/neural
@neural-trader/neuro-divergent		Advanced neural forecasting library	7.7 MB	npm i @neural-trader/neuro-divergent

Trading Components

Package	Version	Description	Size	Install
@neural-trader/backtesting		Historical backtesting engine	2.6 MB	npm i @neural-trader/backtesting
@neural-trader/brokers		Multi-broker integrations (Alpaca, IBKR, etc.)	2.6 MB	npm i @neural-trader/brokers
@neural-trader/execution		Order execution and routing	2.6 MB	npm i @neural-trader/execution
@neural-trader/features		Technical indicators and feature engineering	2.6 MB	npm i @neural-trader/features
@neural-trader/market-data		Real-time and historical market data	2.6 MB	npm i @neural-trader/market-data
@neural-trader/portfolio		Portfolio management and tracking	2.6 MB	npm i @neural-trader/portfolio
@neural-trader/risk		Risk analysis (VaR, CVaR, Monte Carlo)	2.6 MB	npm i @neural-trader/risk
@neural-trader/strategies		Trading strategy implementations	2.6 MB	npm i @neural-trader/strategies

Specialized Strategies

Package	Version	Description	Size	Install
@neural-trader/news-trading		News sentiment analysis and trading	2.6 MB	npm i @neural-trader/news-trading
@neural-trader/prediction-markets		Prediction market integration (Polymarket)	2.6 MB	npm i @neural-trader/prediction-markets
@neural-trader/sports-betting		Sports betting arbitrage and Kelly sizing	2.6 MB	npm i @neural-trader/sports-betting
@neural-trader/syndicate		Collaborative investment syndicates	174 KB	npm i @neural-trader/syndicate

Tools & Protocols

Package	Version	Description	Size	Install
@neural-trader/benchoptimizer		Performance benchmarking and optimization	1.5 MB	npm i @neural-trader/benchoptimizer
@neural-trader/mcp		Model Context Protocol integration	2.6 MB	npm i @neural-trader/mcp
@neural-trader/mcp-protocol		MCP protocol specifications	42 KB	npm i @neural-trader/mcp-protocol
neural-trader		Main neural-trader CLI and metapackage	2.6 MB	npm i neural-trader

Package Features

@neural-trader/backend (v2.2.0)

High-performance Rust NAPI bindings - 4.4 MB

• ✅ Trading: executeTrade, runBacktest, simulateTrade, quickAnalysis
• ✅ Neural Models: neuralForecast, neuralTrain, neuralEvaluate, neuralBacktest, neuralOptimize
• ✅ Sports Betting: getSportsEvents, getSportsOdds, findSportsArbitrage, calculateKellyCriterion
• ✅ Syndicate Management: FundAllocationEngine, ProfitDistributionSystem, VotingSystem
• ✅ Security: JWT auth, API keys, rate limiting, DDoS protection, audit logging
• ✅ Risk Management: VaR/CVaR analysis, portfolio rebalancing, correlation analysis
• ✅ E2B Sandboxes: Isolated code execution environments
• ✅ News Trading: Real-time sentiment analysis and news collection

Example Usage:

const { executeTrade, neuralForecast, getSystemInfo } = require('@neural-trader/backend');

// Get system info
const info = getSystemInfo();
console.log('Version:', info.version);

// Neural forecasting
const forecast = await neuralForecast({
  symbol: 'AAPL',
  horizon: 5,
  model: 'LSTM'
});

// Execute trade
const result = await executeTrade({
  strategy: 'momentum_trader',
  symbol: 'SPY',
  action: 'buy',
  quantity: 100
});

@neural-trader/neural (v2.1.2)

27 Neural Forecasting Models - 10.3 MB - 78.75x Performance Boost

Supported Models:

• Basic: MLP, DLinear, NLinear, RLinear
• Recurrent: RNN, LSTM, GRU
• Advanced: NHITS, NBEATS, TFT, DeepAR
• Transformers: Transformer, Informer, Autoformer, FedFormer, PatchTST, ITransformer
• Specialized: TCN, BiTCN, TimesNet, StemGNN, TSMixer, TimeLLM, DeepNPTS, TIDE

Performance Optimizations:

• 🚀 SIMD Vectorization: 2.5-3.8x speedup (AVX2, AVX-512, NEON)
• 🚀 Rayon Parallelization: 6.94x on 8 cores
• 🚀 Flash Attention: 4.2x speedup, 256x memory reduction
• 🚀 Mixed Precision FP16: 1.8x speedup, 50% memory savings
• 🚀 Combined: 78.75x overall speedup

Example Usage:

const { NeuralModel, BatchPredictor, listModelTypes } = require('@neural-trader/neural');

// List available models
const models = listModelTypes();
console.log('Available:', models); // 27 models

// Create LSTM model
const model = new NeuralModel({
  modelType: 'LSTM',
  inputSize: 10,
  horizon: 5,
  hiddenSize: 128,
  numLayers: 3
});

// Batch predictions
const predictor = new BatchPredictor();
const results = await predictor.predict(data, {
  model: 'Transformer',
  batchSize: 32
});

Platform Support

Current Release:

• ✅ Linux x86_64 (GNU libc)

Coming Soon (v2.3.0+):

• macOS x86_64 (Intel)
• macOS ARM64 (Apple Silicon)
• Windows x86_64 (MSVC)
• Linux ARM64 (GNU/MUSL)

Quick Install

# Install everything (metapackage)
npm install neural-trader

# Or install specific packages
npm install @neural-trader/backend        # Core trading backend
npm install @neural-trader/neural         # 27 neural models
npm install @neural-trader/strategies     # Trading strategies
npm install @neural-trader/risk           # Risk management

# Install all trading components
npm install @neural-trader/backend \
            @neural-trader/neural \
            @neural-trader/strategies \
            @neural-trader/risk \
            @neural-trader/portfolio \
            @neural-trader/execution

# Install specialized strategies
npm install @neural-trader/sports-betting       # Sports arbitrage
npm install @neural-trader/prediction-markets   # Polymarket
npm install @neural-trader/news-trading         # Sentiment trading
npm install @neural-trader/syndicate            # Collaborative pools

Documentation

• Backend API: See package README for 60+ function signatures
• Neural Models: 27 model architectures documented
• Performance: Benchmark results

📡 API Endpoints

Core Endpoints

Authentication (Optional)

Trading Operations

Portfolio & Risk

🔧 Configuration

Environment Variables

# Authentication (Optional)
AUTH_ENABLED=false              # Enable/disable JWT auth
JWT_SECRET_KEY=your-secret-key  # JWT signing key
AUTH_USERNAME=admin             # Default username
AUTH_PASSWORD=changeme          # Default password

# Trading APIs
ALPACA_API_KEY=your-key
ALPACA_SECRET_KEY=your-secret
NEWS_API_KEY=your-key
FINNHUB_API_KEY=your-key

# Application
PORT=8080
LOG_LEVEL=info

Trading Configuration

{
  "strategies": ["momentum_trader", "neural_sentiment"],
  "symbols": ["SPY", "QQQ", "AAPL"],
  "risk_level": "medium",
  "max_position_size": 10000,
  "stop_loss_percentage": 2.0,
  "take_profit_percentage": 5.0,
  "time_frame": "5m",
  "use_gpu": false,
  "enable_news_trading": true,
  "enable_sentiment_analysis": true
}

🔐 Authentication

The platform includes optional JWT authentication that can be enabled for production:

Enable Authentication

# For cloud deployments
fly secrets set AUTH_ENABLED=true --app your-app-name

# For Docker deployments
export AUTH_ENABLED=true

Obtain Token

curl -X POST https://neural-trader.ruv.io/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your-password"}'

Use Token

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://neural-trader.ruv.io/trading/status

See Authentication Guide for detailed documentation.

🧪 Testing

Run Tests

# Test all endpoints
./scripts/test-api-endpoints.sh

# Test authentication
./scripts/test-auth.sh

# Validate core features
./scripts/validate-core-features.sh

# Comprehensive capability test
./scripts/test-all-capabilities.sh

API Testing with cURL

# Start trading
curl -X POST https://neural-trader.ruv.io/trading/start \
  -H "Content-Type: application/json" \
  -d '{"strategies":["momentum_trader"],"symbols":["SPY"]}'

# Check status
curl https://neural-trader.ruv.io/trading/status

# Run backtest
curl -X POST https://neural-trader.ruv.io/trading/backtest \
  -H "Content-Type: application/json" \
  -d '{
    "strategy": "momentum_trader",
    "symbols": ["SPY"],
    "start_date": "2024-01-01",
    "end_date": "2024-06-30"
  }'

📊 Performance Metrics

• Response Time: Average 121ms
• Success Rate: 87.76% in comprehensive tests
• Deployment Size: 327 MB Docker image
• Memory Usage: ~500MB typical
• CPU Usage: <10% idle, 20-40% active trading

🏗️ Architecture

ai-news-trader/
├── src/
│   ├── auth/                 # JWT authentication
│   ├── trading/
│   │   └── strategies/       # Trading strategies
│   ├── optimization/         # Strategy optimization
│   └── main.py              # FastAPI application
├── scripts/                  # Deployment & testing
├── docs/                     # Documentation
└── requirements.txt          # Dependencies

🚀 Deployment

Docker Deployment

Build the Image

# Build from Dockerfile
docker build -t neural-trader:latest .

# Or build with specific Dockerfile
docker build -f Dockerfile.fly -t neural-trader:latest .

Run the Container

# Run with environment file
docker run -d \
  --name neural-trader \
  -p 8080:8080 \
  --env-file .env \
  neural-trader:latest

# Or run with individual environment variables
docker run -d \
  --name neural-trader \
  -p 8080:8080 \
  -e AUTH_ENABLED=false \
  -e JWT_SECRET_KEY="$(openssl rand -hex 32)" \
  -e ALPACA_API_KEY="your-key" \
  neural-trader:latest

Docker Compose

# docker-compose.yml
version: '3.8'
services:
  neural-trader:
    build: .
    ports:
      - "8080:8080"
    environment:
      - AUTH_ENABLED=false
      - JWT_SECRET_KEY=${JWT_SECRET_KEY}
      - ALPACA_API_KEY=${ALPACA_API_KEY}
    volumes:
      - ./logs:/app/logs
    restart: unless-stopped

Cloud Deployment (Fly.io)

# Deploy with the provided script
./scripts/deploy-to-fly.sh

# Or manually
fly deploy --app your-app-name
fly secrets set AUTH_ENABLED=true --app your-app-name

📈 Trading Strategies

Available Strategies

1. Mirror Trader: Copy institutional trading patterns
2. Momentum Trader: Trend-following with technical indicators
3. Enhanced Momentum: Advanced momentum with ML signals
4. Neural Sentiment: News-driven sentiment trading
5. Neural Arbitrage: Cross-market arbitrage opportunities
6. Neural Trend: Trend prediction with neural networks
7. Mean Reversion: Statistical arbitrage
8. Pairs Trading: Market-neutral pair strategies

Risk Levels

• Low: Conservative, 1% position size
• Medium: Balanced, 2.5% position size
• High: Aggressive, 5% position size
• Aggressive: Maximum risk, 10% position size

🛠️ Development

Local Development

# Install dev dependencies
pip install -r requirements-dev.txt

# Run with hot reload
uvicorn src.main:app --reload --port 8080

# Run tests
pytest tests/

# Format code
black src/

Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push branch (git push origin feature/amazing)
5. Open Pull Request

📝 API Documentation

Interactive API documentation available at:

• Swagger UI: https://neural-trader.ruv.io/docs
• ReDoc: https://neural-trader.ruv.io/redoc

🔍 Monitoring

• Health Check: /health
• Prometheus Metrics: /metrics
• Application Logs: Check your deployment platform's logging dashboard

📄 License

MIT License - see LICENSE file for details.

🤝 Support

• Issues: GitHub Issues
• Documentation: /docs
• API Status: https://neural-trader.ruv.io/health

🙏 Acknowledgments

Built with:

• FastAPI - Modern web framework
• Alpaca - Trading API
• Fly.io - Cloud deployment
• python-jose - JWT implementation

Neural Trader by rUv - Advanced AI Trading Made Simple

🌐 Live: https://neural-trader.ruv.io
📚 Docs: https://neural-trader.ruv.io/docs