Hackademia is an interactive learning platform designed to teach cybersecurity concepts through hands-on labs. The application hosts various security "rooms" where users can practice identifying and exploiting vulnerabilities in a safe, controlled environment.
- Interactive Labs: Multiple cybersecurity labs with different focus areas
- Rating System: Users can rate labs and see average ratings
- Lab Previews: Markdown previews of lab content
- Solution Access: Detailed explanations and mitigations for vulnerabilities
- Random Lab Selection: Option to be directed to a random lab
- Python 3.6 or higher
- pip (Python package manager)
- Clone the repository:
git clone https://github.com/Trivulzianus/hackademia.git
cd hackademia- Install required dependencies:
pip install flask werkzeug markdownAdditional dependencies will be automatically installed when the application runs.
Run the application with:
python app-testing.pyThe server will start on port 8000 by default. You can specify a different port using the PORT environment variable:
PORT=5000 python app_testing.pyOnce the server is running, access the platform by navigating to:
http://localhost:8000
Each lab is contained in a folder named Room_* and includes:
vulnerable_app.py: The main lab applicationpreview.md: Markdown preview of the lab contentexplanation_and_mitigation.md: Solution and mitigation strategies- Optional folders:
templates/: HTML templates used by the labstatic/: Static files (CSS, JS, images)
- Create a new folder named
Room_YourLabName - Add a
vulnerable_app.pyfile with a Flask application - Add
preview.mdandexplanation_and_mitigation.mdfiles - Create templates and static folders if needed
The lab's Flask application should follow this structure:
from flask import Flask, render_template_string, request
app = Flask(__name__)
@app.route('/')
def index():
return render_template_string("""
<h1>Your Lab Title</h1>
<p>Lab content goes here</p>
""")
# Add more routes as needed
if __name__ == '__main__':
app.run(debug=True)The platform uses SQLite to store user ratings:
ratings.db: Contains user ratings for each lab
Logs are written to room_server.log and include:
- Server startup information
- Request handling details
- Error messages
- Lab loading information
The application uses Flask's DispatcherMiddleware to route requests to the appropriate lab application. Each lab is loaded dynamically and wrapped with middleware that handles path routing.
This project is licensed under the MIT License - see the LICENSE file for details.