Yosef-Ali/amharic-llm-finetuning

amharic-llm-finetuning # 🇪🇹 Amharic H-Net: Advanced AI Text Generation System A state-of-the-art Amharic text generation system powered by Hierarchical Network (H-Net) architecture. Features production-ready REST API, modern web interface, comprehensive monitoring, and enterprise-grade security. ## ✨ What's New in This Revision - 🔧 **Enhanced Dependencies**: Updated to latest PyTorch, Transformers, and FastAPI versions - 🛡️ **Security Improvements**: Input validation, rate limiting, and secure Docker setup - 📊 **Monitoring & Metrics**: Prometheus metrics and structured logging - 🎨 **Modern UI**: Redesigned web interface with better UX - 🐳 **Optimized Docker**: Multi-stage builds and non-root user setup - ⚙️ **Configuration Management**: Centralized config system with environment support - 🧪 **Better Testing**: Enhanced test coverage and CI/CD ready - 📚 **Improved Documentation**: Comprehensive setup and usage guides ## 🚀 Quick Start ### Option 1: Automated Setup (Recommended) ```bash # Clone the repository git clone cd Amharic-Hnet-Qwin # Run the setup script ./setup.sh # Activate virtual environment source amharic_env/bin/activate # Start the API server python api_server.py ``` ### Option 2: Manual Setup ```bash # Create virtual environment python3 -m venv amharic_env source amharic_env/bin/activate # Install dependencies pip install -r requirements.txt pip install -r requirements-api.txt # Start the API server python api_server.py ``` ### Option 3: Docker Setup ```bash # Build and run with Docker Compose docker-compose up --build # Or build manually docker build -t amharic-hnet . docker run -p 8000:8000 amharic-hnet ``` ## 🌐 Access the Application - **Web Interface**: Open `web_interface.html` in your browser - **API Documentation**: localhost - **Health Check**: localhost - **Metrics**: localhost (if enabled) ## 🧪 Test the API ```bash # Basic text generation curl -X POST "localhost" \ - …