Sign inSign up

xuxuclassmate/trading-assistant

By xuxuclassmate

ā€¢Updated 6 months ago

AI-Powered Trading Decision Support System - Technical Analysis, Trading Signals, Position Managemen

Image
0

1.6K

xuxuclassmate/trading-assistant repository overview

ā šŸš€ OpenClaw Trading Assistant

Your AI-Powered Trading Decision Support System

Version Docker Pulls License

šŸ“š Documentationā  ā€¢ šŸ™ GitHubā  ā€¢ šŸ“¦ PyPIā 

ā šŸ“– What is Trading Assistant?

Trading Assistant is a comprehensive trading decision support system that provides:

  • šŸ“Š Technical Analysis - Support & Resistance levels with multiple algorithms
  • šŸŽÆ Trading Signals - RSI, MACD, Moving Averages combined signals
  • šŸ’° Position Calculator - Risk-based position sizing
  • šŸ”” Price Alerts - Automated stop-loss and take-profit monitoring
  • šŸŒ Multi-language - English & Chinese support

Perfect for traders who want data-driven insights without the noise.

ā šŸš€ Quick Start

ā 1ļøāƒ£ Pull the Image
docker pull xuxuclassmate/trading-assistant:latest
ā 2ļøāƒ£ Create Configuration
# Create config directory
mkdir -p ta-config && cd ta-config

# Download .env template
curl -O https://raw.githubusercontent.com/XuXuClassMate/trading-assistant/main/.env.example
cp .env.example .env

# Download watchlist template
curl -O https://raw.githubusercontent.com/XuXuClassMate/trading-assistant/main/watchlist.txt.example
cp watchlist.txt.example watchlist.txt
ā 3ļøāƒ£ Configure API Keys

Edit .env with your free API keys:

nano .env

# Get free API keys:
# Twelve Data: https://twelvedata.com/pricing (800 calls/day)
# Alpha Vantage: https://www.alphavantage.co/support/#api-key (25 calls/day)

TWELVE_DATA_API_KEY=your_key_here
ALPHA_VANTAGE_API_KEY=your_key_here
LANGUAGE=en  # or 'zh' for Chinese
ā 4ļøāƒ£ Run!

Interactive Mode:

docker run --rm -it \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  xuxuclassmate/trading-assistant:latest

One-Command Analysis:

docker run --rm -it \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  xuxuclassmate/trading-assistant:latest \
  ta all

ā šŸ–„ļø CLI Commands

CommandShortcutDescription
ta-Start interactive mode
ta sigta signalsGenerate trading signals
ta srta support-resistanceAnalyze support/resistance
ta posta positionCalculate position size
ta alertsta alertManage price alerts
ta allta analyzeRun all analysis
ta vta versionShow version
ta hta helpShow help

ā šŸ“Š Example Output

ā Trading Signals
$ docker run --rm -it xuxuclassmate/trading-assistant:latest ta sig

šŸ“ˆ Generating signals...

NVDA:
  RSI: 52.34 [Neutral]
  MACD: 0.1234 [Bullish]
  Moving Averages: [Bullish]
  Combined: Bullish (score: 3)
  Recommendation: BUY (Confidence: Medium)

AAPL:
  RSI: 45.67 [Neutral]
  MACD: -0.0567 [Bearish]
  Moving Averages: [Neutral]
  Combined: Neutral (score: 1)
  Recommendation: HOLD (Confidence: Low)

āœ… Done!
ā Position Calculator
$ docker run --rm -it xuxuclassmate/trading-assistant:latest \
  ta pos --symbol NVDA --price 175 --capital 10000 --risk 2

šŸ’° Calculating position...

Symbol: NVDA
Entry Price: $175.00
Total Capital: $10,000.00
Risk Percentage: 2%
Risk Amount: $200.00

Recommended Position:
  Shares: 57
  Position Value: $9,975.00
  Stop Loss: $171.50 (2% below entry)
  Max Loss: $200.00

āœ… Done!

ā šŸ“‹ Watchlist Configuration

Edit watchlist.txt with your favorite stocks:

NVDA
AAPL
MSFT
GOOGL
TSLA
AMD
META
AMZN

One symbol per line. The assistant will analyze all stocks in your watchlist.

ā šŸ”§ Advanced Usage

ā Run in Background
docker run -d --name trading-assistant \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  xuxuclassmate/trading-assistant:latest
ā View Logs
docker logs -f trading-assistant
ā Update to Latest
docker pull xuxuclassmate/trading-assistant:latest
docker stop trading-assistant
docker rm trading-assistant
# Re-run with same command
ā Custom Environment Variables
docker run --rm -it \
  -e TWELVE_DATA_API_KEY=your_key \
  -e ALPHA_VANTAGE_API_KEY=your_key \
  -e LANGUAGE=en \
  xuxuclassmate/trading-assistant:latest

ā šŸ“š Documentation

For complete guides, visit:

ā šŸ› ļø Alternative Installation Methods

MethodCommandTime
Docker ā­docker pull xuxuclassmate/trading-assistant:latest5 min
pippip install trading-assistant10 min
npmnpm install -g @xuxuclassmate/trading-assistant10 min
Sourcegit clone + pip install -e .15 min

ā ā“ FAQ

ā Q: Where do I get API keys?

A: Both are free:

ā Q: Can I use this for real trading?

A: This is a decision support tool, not financial advice. Always do your own research and consult with a financial advisor.

ā Q: How often should I run analysis?

A: Depends on your trading style:

  • Day traders: Every 15-30 minutes during market hours
  • Swing traders: Once or twice daily
  • Long-term: Weekly is sufficient
ā Q: My API calls are rate limited!

A: Upgrade to paid tier or reduce analysis frequency. Twelve Data offers more generous free limits (800/day vs 25/day).

ā šŸ› Troubleshooting

ā Permission Denied
# Run with current user
docker run --rm -it \
  -u $(id -u):$(id -g) \
  -v $(pwd)/.env:/app/.env \
  -v $(pwd)/watchlist.txt:/app/watchlist.txt \
  xuxuclassmate/trading-assistant:latest
ā Command Not Found

Make sure you're using the correct command:

# Correct
ta
ta sig
ta all

# Also works (full name)
trading-assistant
ā Volume Mount Issues

Use absolute paths:

docker run --rm -it \
  -v /absolute/path/to/.env:/app/.env \
  -v /absolute/path/to/watchlist.txt:/app/watchlist.txt \
  xuxuclassmate/trading-assistant:latest

ā šŸ“¦ Image Tags

TagDescription
latestLatest stable release
1.3.1Specific version
1.3Latest 1.3.x

ā šŸ”— Links

ā šŸ“ License

MIT License - See LICENSEā 

Made with ā¤ļø by XuXuClassMate

ā­ Star on GitHubā  ā€¢ šŸ“¦ Pull on Docker Hubā 

Tag summary

Content type

Image

Digest

sha256:cab7aa404ā€¦

Size

143.4 MB

Last updated

6 months ago

docker pull xuxuclassmate/trading-assistant