{"id":48289830,"url":"https://github.com/yashab-cyber/sentiair","last_synced_at":"2026-04-04T23:02:58.938Z","repository":{"id":299671386,"uuid":"1003795915","full_name":"yashab-cyber/sentiair","owner":"yashab-cyber","description":"Sentinair is an advanced offline AI-based Intrusion Detection System tailored for isolated environments such as air-gapped military, industrial, or banking systems. It monitors system behavior patterns and flags anomalies using machine learning - all without needing internet connectivity.","archived":false,"fork":false,"pushed_at":"2025-06-27T14:41:41.000Z","size":240,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T15:30:44.319Z","etag":null,"topics":["code","cybersecurity","ethicalhacking","intrusion-detection-system","python"],"latest_commit_sha":null,"homepage":"https://www.zehrasec.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashab-cyber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-17T17:19:17.000Z","updated_at":"2025-06-27T14:22:45.000Z","dependencies_parsed_at":"2025-06-17T18:43:09.272Z","dependency_job_id":null,"html_url":"https://github.com/yashab-cyber/sentiair","commit_stats":null,"previous_names":["yashab-cyber/sentiair"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yashab-cyber/sentiair","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fsentiair","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fsentiair/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fsentiair/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fsentiair/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashab-cyber","download_url":"https://codeload.github.com/yashab-cyber/sentiair/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fsentiair/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31418287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code","cybersecurity","ethicalhacking","intrusion-detection-system","python"],"created_at":"2026-04-04T23:02:14.203Z","updated_at":"2026-04-04T23:02:58.917Z","avatar_url":"https://github.com/yashab-cyber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sentinair - Offline AI-Powered Behavioral Threat Detection System\r\n\r\n*Created by Yashab Alam, Founder of ZehraSec*\r\n\r\n![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)\r\n![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)\r\n![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux-lightgrey.svg)\r\n![License](https://img.shields.io/badge/license-MIT-green.svg)\r\n![AI Powered](https://img.shields.io/badge/AI-Powered-orange.svg)\r\n![Offline](https://img.shields.io/badge/offline-capable-brightgreen.svg)\r\n![Security](https://img.shields.io/badge/security-threat%20detection-red.svg)\r\n![Status](https://img.shields.io/badge/status-stable-brightgreen.svg)\r\n![GitHub Issues](https://img.shields.io/github/issues/yashab-cyber/sentiair)\r\n![GitHub Stars](https://img.shields.io/github/stars/yashab-cyber/sentiair)\r\n![GitHub Forks](https://img.shields.io/github/forks/yashab-cyber/sentiair)\r\n![GitHub Last Commit](https://img.shields.io/github/last-commit/yashab-cyber/sentiair)\r\n\r\n## Overview\r\nSentinair is an advanced offline AI-based Intrusion Detection System tailored for isolated environments such as air-gapped military, industrial, or banking systems. It monitors system behavior patterns and flags anomalies using machine learning - all without needing internet connectivity.\r\n\r\n## Features\r\n- **Behavioral Tracking Engine**: Monitors file access patterns, USB device events, application launches, system activity, and user interaction patterns\r\n- **Local ML Anomaly Detection**: Uses unsupervised machine learning (Isolation Forest/Autoencoders) to detect behavioral deviations\r\n- **Offline Alerting System**: GUI alerts, CLI support, and manual export capabilities\r\n- **Report Generation**: Detailed logs in PDF/CSV format with optional YARA rule integration\r\n- **Stealth Mode**: Hidden background operation with admin authentication\r\n- **Cross-Platform**: Supports Linux (Debian/Kali/Ubuntu) and Windows 10+\r\n\r\n## 💰 Support This Project\r\n\r\nSentinair is an open-source project that relies on community support. If you find this tool valuable, please consider supporting its development:\r\n\r\n- 🌟 **Star this repository** to show your support\r\n- 💵 **Make a donation** to fund development - see [DONATE.md](DONATE.md) for details\r\n- 🤝 **Contribute code** by submitting pull requests\r\n- 📝 **Report issues** to help improve the project\r\n- 📢 **Share** with others who might benefit from this tool\r\n\r\n**Your support helps us:**\r\n- Improve AI detection models\r\n- Add new features and capabilities\r\n- Maintain cross-platform compatibility\r\n- Provide better documentation and support\r\n\r\n👉 **[View Donation Options](DONATE.md)**\r\n\r\n## Installation\r\n\r\n### Automated Installation Scripts\r\n\r\nFor production deployment, use the automated installation scripts in the `install/` directory:\r\n\r\n#### Linux\r\n```bash\r\n# Ubuntu/Debian\r\nchmod +x install/install_ubuntu.sh\r\nsudo ./install/install_ubuntu.sh\r\n\r\n# CentOS/RHEL/Fedora  \r\nchmod +x install/install_centos.sh\r\nsudo ./install/install_centos.sh\r\n\r\n# Kali Linux\r\nchmod +x install/install_kali.sh\r\nsudo ./install/install_kali.sh\r\n```\r\n\r\n#### Windows\r\n```powershell\r\n# PowerShell (Recommended - includes service installation)\r\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\r\n.\\install\\install_windows.ps1\r\n\r\n# Or use the batch script\r\n.\\install\\install_windows.bat\r\n```\r\n\r\n### Manual Installation\r\n\r\n#### Prerequisites\r\n- Python 3.8+\r\n- SQLite3\r\n- Required Python packages (see requirements.txt)\r\n\r\n#### Setup\r\n```bash\r\n# Clone or extract the project\r\ncd sentinair\r\n\r\n# Install dependencies\r\npip install -r requirements.txt\r\n\r\n# Initialize the system\r\npython setup.py\r\n\r\n# Run the application\r\npython main.py\r\n```\r\n\r\n## 🚀 Quick Start\r\n\r\n```bash\r\n# 1. Extract/clone the project\r\ncd sentinair\r\n\r\n# 2. Install dependencies\r\npip install -r requirements.txt\r\n\r\n# 3. Run initial setup\r\npython setup.py\r\n\r\n# 4. Start the application\r\npython main.py --gui    # GUI mode\r\npython main.py --cli    # CLI mode\r\npython main.py --stealth # Background mode\r\n```\r\n\r\n## 📚 Documentation\r\n\r\n### Complete User Manual\r\nThe `/manual` directory contains comprehensive documentation:\r\n\r\n- **[Installation Guide](manual/01-installation.md)** - Detailed setup instructions for all platforms\r\n- **[Quick Start Guide](manual/02-quickstart.md)** - Get up and running in minutes\r\n- **[Configuration Guide](manual/03-configuration.md)** - Customize system settings\r\n- **[GUI User Guide](manual/04-gui-guide.md)** - Navigate the graphical interface\r\n- **[CLI User Guide](manual/05-cli-guide.md)** - Master the command line\r\n- **[Machine Learning Guide](manual/10-machine-learning.md)** - Understanding AI detection\r\n- **[Troubleshooting](manual/13-troubleshooting.md)** - Solve common issues\r\n- **[Command Reference](manual/18-command-reference.md)** - Complete command guide\r\n\r\n👉 **Start with the [Manual Overview](manual/README.md)**\r\n\r\n### Additional Documentation\r\n- **[Deployment Guide](DEPLOYMENT.md)** - Production deployment checklist\r\n- **[User Guide](USER_GUIDE.md)** - Legacy user documentation\r\n- **[Contributing](CONTRIBUTING.md)** - Development and contribution guidelines\r\n- **[Security Policy](SECURITY.md)** - Security practices and reporting\r\n\r\n## Architecture\r\n\r\n### Core Components\r\n\r\n| Component | Purpose | Key Files |\r\n|-----------|---------|-----------|\r\n| **core/** | Main detection engine and monitors | `engine.py`, `monitors/` |\r\n| **ml/** | Machine learning anomaly detection | `anomaly_detector.py` |\r\n| **gui/** | Graphical user interface | `main_window.py`, dashboard/alerts widgets |\r\n| **cli/** | Command-line interface | `cli_interface.py` |\r\n| **alerts/** | Alert management system | `alert_manager.py` |\r\n| **reports/** | Report generation | `report_generator.py` |\r\n| **utils/** | Core utilities | `config.py`, `database.py`, `logger.py` |\r\n| **config/** | Configuration files | `default.yaml` |\r\n| **signatures/** | YARA detection rules | `default.yar` |\r\n| **install/** | Installation scripts | Platform-specific installers |\r\n| **manual/** | User documentation | Comprehensive guides |\r\n\r\n### Monitoring Capabilities\r\n- **File System**: Track file access, creation, deletion, and modifications\r\n- **USB Devices**: Monitor device insertion/removal and suspicious devices  \r\n- **Processes**: Application launches and executable analysis\r\n- **User Behavior**: Privacy-preserving activity pattern analysis\r\n\r\n## Security Features\r\n- **Offline Operation**: No internet connectivity required\r\n- **Encrypted Storage**: AES-encrypted local data storage\r\n- **Self-Contained**: Complete standalone operation\r\n- **Admin Authentication**: Secure access for sensitive operations\r\n- **Stealth Mode**: Hidden background operation\r\n\r\n## License\r\nMIT License - See [LICENSE](LICENSE) file for details\r\n\r\n## Production Ready\r\nThis project has been cleaned and prepared for deployment:\r\n- ✅ All test and debug files removed\r\n- ✅ Comprehensive documentation in `/manual` directory  \r\n- ✅ Production installation scripts ready\r\n- ✅ Security hardened and validated\r\n- ✅ See [DEPLOYMENT.md](DEPLOYMENT.md) for deployment checklist\r\n\r\n## 🏢 About ZehraSec\r\n\r\n**Sentinair** is developed by **[ZehraSec](https://www.zehrasec.com)**, a cybersecurity company founded by **Yashab Alam**.\r\n\r\n**Connect with ZehraSec:**\r\n- 🌐 **Website:** [www.zehrasec.com](https://www.zehrasec.com)\r\n- 📸 **Instagram:** [@_zehrasec](https://www.instagram.com/_zehrasec?igsh=bXM0cWl1ejdoNHM4)\r\n- 🐦 **X (Twitter):** [@zehrasec](https://x.com/zehrasec?t=Tp9LOesZw2d2yTZLVo0_GA\u0026s=08)\r\n- 💼 **LinkedIn:** [ZehraSec Company](https://www.linkedin.com/company/zehrasec)\r\n\r\n**Connect with Yashab Alam:**\r\n- 💻 **GitHub:** [@yashab-cyber](https://github.com/yashab-cyber)\r\n- 📸 **Instagram:** [@yashab.alam](https://www.instagram.com/yashab.alam)\r\n- 💼 **LinkedIn:** [Yashab Alam](https://www.linkedin.com/in/yashabalam)\r\n\r\n---\r\n\r\n**🛡️ Made with ❤️ by Yashab Alam (Founder of ZehraSec)**\r\n\r\n*© 2025 ZehraSec. Released under MIT License.*\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fsentiair","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashab-cyber%2Fsentiair","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fsentiair/lists"}