A comprehensive exam management and grade calculation tool for Halic University students
Features • Installation • Usage • Technology • Contributing
Halic Exam Genius is a web-based application designed for Halic University students. The application automatically processes official Excel files containing exam dates from the university's announcement page, providing students with easy access to current exam schedules, classroom information, and comprehensive grade calculations through an intuitive web interface.
- Automated Data Processing: Reads and processes Excel files from Halic University announcements
- Current Exam Dates: View up-to-date exam dates and classroom information
- Calendar Integration: Export exam schedules as ICS files for calendar applications
- Multi-language Support: Available in Turkish and English
- Weighted Grade Calculation: Calculate overall grades with customizable exam weights
- Pass/Fail Analysis: Set passing thresholds and see if you've passed the course
- Visual Grade Reports: Generate visual grade summary charts
- Grade Export: Download your grade calculations as images
- Responsive Web Interface: Works on desktop and mobile browsers via Streamlit
- Course Selection: Multi-select interface for choosing specific courses
- Real-time Calculations: Instant grade calculations as you input data
- Python 3.9 or higher
- pip package manager
-
Clone the Repository
git clone https://github.com/eftekin/halic-exam-genius.git cd halic-exam-genius -
Create Virtual Environment (Recommended)
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
-
Install Dependencies
pip install -r requirements.txt
-
Launch the Application
streamlit run app.py
-
Access the Application Open your browser and navigate to http://localhost:8501
- Launch the Application: Run the Streamlit app using
streamlit run app.py - View Exam Schedule: Browse current semester exam dates
- Select Courses: Choose specific courses to see their exam information
- Calculate Grades: Input your exam scores and weights for automatic calculation
- Export Results: Download your schedules as ICS files or grade charts as images
- The application automatically fetches data from Halic University's official Excel files for current semester exams
- Frontend Framework: Streamlit - Web application framework
- Backend Language: Python 3.9+
- Data Processing: Pandas - Data manipulation and analysis
- Excel Processing: Openpyxl - Excel file reading and processing
- Visualization: Plotly - Interactive charts and visualizations
- Image Export: Kaleido - Static image export for Plotly charts
- Date Handling: Datetime - Date and time operations
- Text Processing: Unidecode - Unicode text normalization
- HTTP Requests: Requests - Fetching data from university servers
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Make your changes
- Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- 🐛 Report bugs or issues
- 💡 Suggest new features or improvements
- 📝 Improve documentation
- 🌐 Help with translations
- 🔧 Submit code improvements
This project is licensed under the MIT License - see the LICENSE file for details.
- Issues: Report bugs or request features on GitHub Issues
- Discussions: Join our GitHub Discussions
- Email: For direct support, contact the maintainer
- Halic University for providing the data structure and requirements
- The open-source community for the amazing tools and libraries
- All contributors who help improve this project
Made with ❤️ for Halic University Students
⭐ Star this repo if it helped you! ⭐