Skip to content

ayoub0030/Security-Agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

Security Agent

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.

Prerequisites

  • Python 3.8 or higher
  • Windows operating system
  • Administrative privileges for system monitoring features
  • At least 4GB RAM and 2GB of free disk space

Installation

  1. Clone the repository:
git clone https://github.com/ayoub0030/Security-Agent.git
cd Security-Agent
  1. Create a virtual environment:
python -m venv venv
.\venv\Scripts\activate
  1. Install required dependencies:
pip install -r requirements.txt

Configuration

  1. Copy the .env.example file to .env
  2. Update the environment variables in .env with your specific configurations:
    • LOG_LEVEL: Set to DEBUG, INFO, WARNING, or ERROR
    • SCAN_INTERVAL: Time in seconds between security scans
    • ALERT_EMAIL: Email address for security notifications

Usage

  1. Start the security agent:
python main.py
  1. Access the web interface:
    • Open your browser and navigate to http://localhost:5000
    • Log in with your administrator credentials

Features

  • Real-time system monitoring
  • Security threat detection
  • Automated system hardening
  • Security log analysis
  • Email notifications for security events
  • Web-based dashboard

Security Considerations

  • Always run the agent with appropriate permissions
  • Regularly update the system and dependencies
  • Keep your .env file secure and never commit it to version control
  • Monitor the security logs regularly

Troubleshooting

Common issues and solutions:

  1. If the agent fails to start:

    • Check if all dependencies are installed
    • Verify your Python version
    • Ensure you have administrative privileges
  2. If monitoring features are not working:

    • Check your firewall settings
    • Verify the configuration in .env
    • Review the logs in the logs directory

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published