14863929a0
- Translate all Chinese comments and strings in webui/app.py - Translate all Chinese comments and strings in webui/run.py - Translate all Chinese comments and strings in webui/start.sh - Translate all Chinese content in webui/README.md - Translate all Chinese content in webui/templates/index.html - Add prediction results directory for analysis - Complete internationalization of webui module
136 lines
4.0 KiB
Markdown
136 lines
4.0 KiB
Markdown
# Kronos Web UI
|
|
|
|
Web user interface for Kronos financial prediction model, providing intuitive graphical operation interface.
|
|
|
|
## ✨ Features
|
|
|
|
- **Multi-format data support**: Supports CSV, Feather and other financial data formats
|
|
- **Smart time window**: Fixed 400+120 data point time window slider selection
|
|
- **Real model prediction**: Integrated real Kronos model, supports multiple model sizes
|
|
- **Prediction quality control**: Adjustable temperature, nucleus sampling, sample count and other parameters
|
|
- **Multi-device support**: Supports CPU, CUDA, MPS and other computing devices
|
|
- **Comparison analysis**: Detailed comparison between prediction results and actual data
|
|
- **K-line chart display**: Professional financial K-line chart display
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Method 1: Start with Python script
|
|
```bash
|
|
cd webui
|
|
python run.py
|
|
```
|
|
|
|
### Method 2: Start with Shell script
|
|
```bash
|
|
cd webui
|
|
chmod +x start.sh
|
|
./start.sh
|
|
```
|
|
|
|
### Method 3: Start Flask application directly
|
|
```bash
|
|
cd webui
|
|
python app.py
|
|
```
|
|
|
|
After successful startup, visit http://localhost:7070
|
|
|
|
## 📋 Usage Steps
|
|
|
|
1. **Load data**: Select financial data file from data directory
|
|
2. **Load model**: Select Kronos model and computing device
|
|
3. **Set parameters**: Adjust prediction quality parameters
|
|
4. **Select time window**: Use slider to select 400+120 data point time range
|
|
5. **Start prediction**: Click prediction button to generate results
|
|
6. **View results**: View prediction results in charts and tables
|
|
|
|
## 🔧 Prediction Quality Parameters
|
|
|
|
### Temperature (T)
|
|
- **Range**: 0.1 - 2.0
|
|
- **Effect**: Controls prediction randomness
|
|
- **Recommendation**: 1.2-1.5 for better prediction quality
|
|
|
|
### Nucleus Sampling (top_p)
|
|
- **Range**: 0.1 - 1.0
|
|
- **Effect**: Controls prediction diversity
|
|
- **Recommendation**: 0.95-1.0 to consider more possibilities
|
|
|
|
### Sample Count
|
|
- **Range**: 1 - 5
|
|
- **Effect**: Generate multiple prediction samples
|
|
- **Recommendation**: 2-3 samples to improve quality
|
|
|
|
## 📊 Supported Data Formats
|
|
|
|
### Required Columns
|
|
- `open`: Opening price
|
|
- `high`: Highest price
|
|
- `low`: Lowest price
|
|
- `close`: Closing price
|
|
|
|
### Optional Columns
|
|
- `volume`: Trading volume
|
|
- `amount`: Trading amount (not used for prediction)
|
|
- `timestamps`/`timestamp`/`date`: Timestamp
|
|
|
|
## 🤖 Model Support
|
|
|
|
- **Kronos-mini**: 4.1M parameters, lightweight fast prediction
|
|
- **Kronos-small**: 24.7M parameters, balanced performance and speed
|
|
- **Kronos-base**: 102.3M parameters, high quality prediction
|
|
|
|
## 🖥️ GPU Acceleration Support
|
|
|
|
- **CPU**: General computing, best compatibility
|
|
- **CUDA**: NVIDIA GPU acceleration, best performance
|
|
- **MPS**: Apple Silicon GPU acceleration, recommended for Mac users
|
|
|
|
## ⚠️ Notes
|
|
|
|
- `amount` column is not used for prediction, only for display
|
|
- Time window is fixed at 400+120=520 data points
|
|
- Ensure data file contains sufficient historical data
|
|
- First model loading may require download, please be patient
|
|
|
|
## 🔍 Comparison Analysis
|
|
|
|
The system automatically provides comparison analysis between prediction results and actual data, including:
|
|
- Price difference statistics
|
|
- Error analysis
|
|
- Prediction quality assessment
|
|
|
|
## 🛠️ Technical Architecture
|
|
|
|
- **Backend**: Flask + Python
|
|
- **Frontend**: HTML + CSS + JavaScript
|
|
- **Charts**: Plotly.js
|
|
- **Data processing**: Pandas + NumPy
|
|
- **Model**: Hugging Face Transformers
|
|
|
|
## 📝 Troubleshooting
|
|
|
|
### Common Issues
|
|
1. **Port occupied**: Modify port number in app.py
|
|
2. **Missing dependencies**: Run `pip install -r requirements.txt`
|
|
3. **Model loading failed**: Check network connection and model ID
|
|
4. **Data format error**: Ensure data column names and format are correct
|
|
|
|
### Log Viewing
|
|
Detailed runtime information will be displayed in the console at startup, including model status and error messages.
|
|
|
|
## 📄 License
|
|
|
|
This project follows the license terms of the original Kronos project.
|
|
|
|
## 🤝 Contributing
|
|
|
|
Welcome to submit Issues and Pull Requests to improve this Web UI!
|
|
|
|
## 📞 Support
|
|
|
|
If you have questions, please check:
|
|
1. Project documentation
|
|
2. GitHub Issues
|
|
3. Console error messages
|