Security Agent , was submitted to the NOSU Hackathon to combat the increasing threat of scam calls targeting vulnerable individuals. NexusAI serves as a virtual assistant, designed to screen unknown callers and identify potentially suspicious interactions using sentiment analysis. Leveraging Google Gemini AI, Twilio for call handling, ElevenLabs for lifelike voice responses, and Firebase for optimized caching, NexusAI provides users with insights and recommended actions after each call. This allows individuals to better protect themselves against scams and provides a proactive approach to a growing problem. Despite facing challenges such as latency, the successful development of this intelligent call screening system was a significant accomplishment. A robust security monitoring and management system designed to protect and monitor your system's security status.
- Python 3.8 or higher
- Windows operating system
- Administrative privileges for system monitoring features
- At least 4GB RAM and 2GB of free disk space
- Clone the repository:
git clone https://github.com/ayoub0030/Security-Agent.git
cd Security-Agent- Create a virtual environment:
python -m venv venv
.\venv\Scripts\activate- Install required dependencies:
pip install -r requirements.txt- Copy the
.env.examplefile to.env - Update the environment variables in
.envwith your specific configurations:LOG_LEVEL: Set to DEBUG, INFO, WARNING, or ERRORSCAN_INTERVAL: Time in seconds between security scansALERT_EMAIL: Email address for security notifications
- Start the security agent:
python main.py- Access the web interface:
- Open your browser and navigate to
http://localhost:5000 - Log in with your administrator credentials
- Open your browser and navigate to
- Real-time system monitoring
- Security threat detection
- Automated system hardening
- Security log analysis
- Email notifications for security events
- Web-based dashboard
- Always run the agent with appropriate permissions
- Regularly update the system and dependencies
- Keep your
.envfile secure and never commit it to version control - Monitor the security logs regularly
Common issues and solutions:
-
If the agent fails to start:
- Check if all dependencies are installed
- Verify your Python version
- Ensure you have administrative privileges
-
If monitoring features are not working:
- Check your firewall settings
- Verify the configuration in
.env - Review the logs in the
logsdirectory
- Fork the repository
- Create a feature branch
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.