4.3 KiB
Security Policy
Supported Versions
We provide security updates for the following versions:
- Latest minor version: Active support (e.g., v0.9.x)
- Previous minor versions: Bug-fix support only
- Versions older than 3 minor versions: No support
Example:
- v0.9.0-0.9.x → Full support (latest)
- v0.8.0-0.8.x → Bug-fix support only
- v0.7.x and below → No support
Reporting a Vulnerability
Do not open a public issue or pull request for security vulnerabilities.
Instead, use GitHub Security Advisories to report privately, or email vpn.alpamys@gmail.com with:
- Description: A clear explanation of the vulnerability
- Steps to Reproduce: How to trigger or demonstrate the issue
- Affected Versions: Which Soup versions are impacted
- Suggested Fix (optional): Any proposed solutions
- Contact Info: Your email for follow-up (optional)
What to Include
To: vpn.alpamys@gmail.com
Subject: Security Vulnerability Report: [Brief Title]
Description:
[Explain the vulnerability in detail]
Affected Component:
[e.g., data/loader.py, trainer/sft.py, etc.]
Steps to Reproduce:
1. [Step 1]
2. [Step 2]
3. ...
Impact:
[What could go wrong? Data exposure? RCE? DoS?]
Suggested Fix (optional):
[Your proposed solution, if any]
Response Timeline
- Initial Response: Within 48 hours
- Assessment: 1-3 business days
- Fix Development: Varies by severity
- Patch Release: As soon as possible after fix verification
- Public Disclosure: Coordinated with reporter (typically 90 days after patch release)
Severity Levels
- Critical: Remote code execution, data exposure, complete compromise (patch within 24-48 hours)
- High: Authentication bypass, privilege escalation, denial of service (patch within 1 week)
- Medium: Information disclosure, partial compromise (patch within 2 weeks)
- Low: Minor issues with limited impact (patch in next regular release)
Security Best Practices
When using Soup, follow these practices to stay secure:
1. Keep Soup Updated
pip install --upgrade soup-cli
2. Protect API Keys
Never commit API keys or secrets to version control. Use environment variables:
export HUGGINGFACE_TOKEN=your_token_here
export WANDB_API_KEY=your_key_here
soup train
3. Validate Data
- Only use trusted datasets
- Verify checksums for large datasets
- Inspect data for malicious content before training
4. Model Permissions
- Be cautious when downloading models from untrusted sources
- Use model hub providers with verified publishers (HuggingFace, Meta, etc.)
- Keep track of which models you've fine-tuned and their base model sources
5. GPU/Compute Safety
- Run on isolated machines if training on sensitive data
- Clear cache and temporary files after training
- Don't share fine-tuned models containing sensitive information
Known Vulnerabilities
We maintain a log of known security issues and their fixes. This will be updated as issues are discovered and resolved.
Current Status
No known critical vulnerabilities in current releases.
Security Scanning
- All code is scanned with
rufffor style and common issues - Dependencies are regularly updated to patch known CVEs
- GitHub's dependency scanning alerts us to vulnerable dependencies
- We use GitHub Actions CI/CD for continuous integration
Dependency Updates
We actively monitor and update dependencies:
- Major dependency updates: Tested in PR before merging
- Security patches: Applied immediately and released as patch versions
- Deprecated dependencies: Replaced proactively
Coming Soon
- Automated dependency scanning
- SBOM (Software Bill of Materials) for each release
- Third-party security audit (after 1.0.0 release)
Questions?
If you have security questions (not vulnerability reports) or need clarification:
- Open a GitHub Discussion tagged
security - Open a GitHub Issue (non-vulnerability inquiries)
- Check our CONTRIBUTING.md for general support
License
This Security Policy is provided under the MIT license, same as the Soup project.
Last Updated: March 2026
For the latest version of this policy, visit: https://github.com/MakazhanAlpamys/Soup/blob/main/SECURITY.md