This project is a child-safe search engine designed to offer a secure browsing experience for children. It leverages Google’s Custom Search API to allow children to explore the internet safely under their parents' supervision. The application is built with Django, ensuring a robust, scalable, and secure platform.
- Safe Search Filtering: Utilizes Google's Custom Search API to filter out inappropriate content, ensuring that search results are suitable for children.
- Parental Controls: Parents can monitor and control their child's search activities, providing a safe online environment.
- Real-Time Alerts: Sends immediate notifications to parents for any unauthorized search attempts or activities.
- Activity Logging: Keeps a log of all search activities, allowing parents to review their child's online behavior.
- Request Unban: Children can request their parents to unban certain words, promoting a learning opportunity and open communication.
- Report Inappropriate Content: Children can report any inappropriate content, helping to improve the search engine's safety measures.
- Customizable Settings: Parents can customize the search engine settings to suit their child's needs, They can set alert levels and access times as well as take advantage of our custom list of banned words with each child having a diiferent list of banned words thay can't search.
- Discussion Forum: Parents can discuss and share experiences with other parents, fostering a supportive community.
- Educational Resources: Provides access to educational resources and materials, enhancing the child's learning experience and teaching all users about staying safe online.
- Backend Framework: Django
- Frontend Technologies: HTML, CSS, JavaScript (For admin and parental control interfaces)
- APIs: Google Custom Search API
- Database: SQLite (for development), PostgreSQL (for production)
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
- Python 3.6+
- A Google Custom Search API Key
- A Google API Key
- Clone the repository to your local machine:
git clone https://github.com/nafdev01/childprotect.git- Navigate to the project directory:
cd childprotect- Create a virtual environment:
python3 -m venv .venv- Activate the virtual environment:
source .venv/bin/activate- Install the project dependencies:
pip install -r requirements.txt-
Create a
.envfile in the project root directory using the .env.example as a template: -
Run the Django migrations:
python manage.py migrate- Create an admin user:
python manage.py createsuperuser- Start the Django development server:
python manage.py runserver- Access the application at
http://localhost:8000/and the admin interface athttp://localhost:8000/admin/.
- If you set development mode to false you will need to set up a postgresql database for yourapplication. For simplicity and local deployment use the default sqlite database.
- Instructions on how to set up postgresql with django can be found at https://www.digitalocean.com/community/tutorials/how-to-use-postgresql-with-your-django-application-on-ubuntu-20-04
- If you encounter any issues while setting up the project, please feel free to open an issue on the repository.
- If you encounter a database error while running the project, please ensure that you have run the migrations using the
python manage.py migratecommand and are using the correct postgresql database configuration.
- If you would like to contribute to the project, please fork the repository and submit a pull request.
- Google Custom Search API
- Django Community
- All contributors and supporters of this project