skandermahfoudh/tunisian-export-ai

# Tunisian Export AI - Economic Price Prediction Dashboard ## Project Overview An AI-powered dashboard for analyzing and predicting Tunisian agricultural export prices. The system integrates machine learning predictions, LLM-generated reports, and interactive data visualization. ## Features - **AI Price Predictions**: Machine learning models for price forecasting - **LLM Report Generation**: AI-powered market analysis reports - **Interactive Dashboard**: Real-time data visualization and filtering - **Data Export**: Multiple format support (CSV, JSON, XML, Excel) - **Statistical Analysis**: Comprehensive economic statistics ## 📋 Prerequisites ### Essential Software: - **Java Development Kit (JDK) 17** or higher - Download from: adoptium.net - Verify: `java -version` - **Apache Maven 3.6+** - Download from: maven.apache.org - Verify: `mvn -v` ### Optional AI Components: 1. **For Local LLM (Recommended)**: - Install Ollama: ollama.ai - Pull a model: `ollama pull tinyllama` or `ollama pull llama2` 2. **For Cloud LLM**: - OpenAI API key from: platform.openai.com - Set environment variable: `OPENAI_API_KEY=your-key-here` ## 🚀 Installation & Setup ### Step 1: Download and Extract Project ```bash # Download the project ZIP from Moodle/Google Drive unzip tunisian-export-ai.zip cd tunisian-export-ai