Welcome to Attendy, a web application designed to make student attendance management seamless and efficient. Whether you're a student, educator, or administrator, Attendy simplifies tracking attendance, organizing courses, and managing teaching records.
GitHub Repository: Attendy on GitHub
Attendy is built with the goal of providing a user-friendly platform for educational institutions to manage attendance across various courses. The platform is feature-rich, offering a dashboard for quick overviews, tools for managing courses, students, lecturers, and detailed logs for teaching sessions.
- Dashboard: Get a comprehensive overview of attendance across all your courses.
- Course Management: Organize and track attendance for each course.
- Student Management: Maintain detailed records of student attendance.
- Lecturers Management: Empower lecturers to manage class attendance easily.
- Teaching Records Management: Log and track teaching sessions and attendance data.
- Python 3.x
- pip (Python package installer)
- Git
-
Clone the Repository:
git clone https://github.com/Joel-Fah/attendy.git cd attendy -
Create a Virtual Environment:
python -m venv venv
-
Activate the Virtual Environment:
venv\Scripts\activate
-
Install the Dependencies:
pip install -r requirements.txt
-
Setup the Database:
- For SQLite (default):
python manage.py migrate
- For PostgreSQL:
- Ensure PostgreSQL is installed and a database is created.
- Update the
DATABASESsettings insettings.pywith your PostgreSQL credentials. - Run migrations:
python manage.py migrate
- For SQLite (default):
-
Run the Development Server:
python manage.py runserver
-
Clone the Repository:
git clone https://github.com/Joel-Fah/attendy.git cd attendy -
Create a Virtual Environment:
python3 -m venv venv
-
Activate the Virtual Environment:
source venv/bin/activate -
Install the Dependencies:
pip install -r requirements.txt
-
Setup the Database:
- For SQLite (default):
python3 manage.py migrate
- For PostgreSQL:
- Ensure PostgreSQL is installed and a database is created.
- Update the
DATABASESsettings insettings.pywith your PostgreSQL credentials. - Run migrations:
python3 manage.py migrate
- For SQLite (default):
-
Run the Development Server:
python3 manage.py runserver
After setting up the project, access the application by navigating to http://127.0.0.1:8000/ or localhost:8000 in your web browser.
We welcome contributions from the community! Whether it's reporting bugs, suggesting features, or submitting pull requests, your involvement is crucial to the project's growth. Please read our Code of Conduct and Contributing Guidelines before contributing.
This project is licensed under the MIT License - see the LICENSE file for details.
For questions, suggestions, or feedback, feel free to open an issue or reach out via the repository's contact links.
Thank you for checking out Attendy!
Thank you for helping us maintain a positive and inclusive community!
I poured everything into this—my sleepless nights, my broken spirit, my tears when no one was watching. I wanted to quit, more times than I can count, but something deep inside, something by God’s grace and strength, kept me pushing through the pain, the screams, the endless frustration. Now, standing at the finish line, I feel the weight lift, the peace settle in, and I realize—every ounce of pain was the price for this moment of pure, overwhelming relief.
