Skip to content

Latest commit

 

History

History
105 lines (71 loc) · 2.52 KB

File metadata and controls

105 lines (71 loc) · 2.52 KB

🤝 Contributing to SafeVision

Thank you for your interest in contributing to SafeVision!
Your contributions will help us create a safer world through AI-driven real-time surveillance.

This project is part of the IEEE Summer of Projects (SoC) and is currently in an early development phase.
We are actively looking for contributors to help expand and improve the system.


📚 How You Can Contribute

We welcome contributions in the following areas:

  • 🧠 Integrating new AI models for body language, facial expression, and crowd behavior analysis.
  • 🎯 Improving crime detection accuracy and risk evaluation algorithms.
  • 🖥️ Building a more interactive user interface.
  • 🛠️ Writing unit tests and improving code quality.
  • 🐳 Dockerizing the app for easier deployment.
  • 📜 Improving documentation and tutorials.

🛠 Setting Up Locally

Follow these steps to get started:

  1. Fork the repository.
  2. Clone your fork locally.
  3. Set up a virtual environment (recommended).
  4. Install dependencies:
    pip install flask opencv-python ultralytics
  5. Run the app:
    python app.py

📝 Contribution Process

  1. Open an Issue

    • Before starting any major work, please open an issue to discuss your idea.
    • Look for issues labeled "Good First Issue" or "Help Wanted".
  2. Fork the Repository

  3. Create a Feature Branch

    git checkout -b feature/your-feature-name
  4. Make Your Changes

  5. Test Your Changes

  6. Commit Your Changes

    git commit -m "Add: your meaningful commit message"
  7. Push to Your Fork

    git push origin feature/your-feature-name
  8. Open a Pull Request

    • Follow the pull request template provided.
    • Describe the changes you made and reference related issues.

📢 Code Guidelines

  • Follow clean and readable Python coding practices.
  • Use meaningful commit messages.
  • Comment your code where necessary.
  • Write modular and reusable code.

🛡️ Code of Conduct

Please read our Code of Conduct to ensure a welcoming and respectful environment for everyone.


🎯 Where to Start?

Check the Issues page!
Look for issues labeled:

  • good first issue
  • help wanted

Thank you for helping us make SafeVision better! 💬
We are excited to collaborate with you! 🚀


🚨 Let's Build Safer Spaces Together! 🚨