BioShield v2.0.0 – Public Launch

# BioShield v3.3.5  []() [](https://pypi.org/project/bioshield/) []() []() []() [](https://github.com/emerladcompass/BioShield/actions/workflows/publish.yml) [](https://doi.org/10.5281/zenodo.18224754) [](https://github.com/emerladcompass/BioShield) [](https://pypi.org/project/bioshield/) [](https://emerladcompass.github.io/BioShield/) **Intelligent Soil Monitoring & Auto-Adjustment System** *AI-powered platform for real-time soil analysis, automatic correction, and predictive reporting* [📖 Documentation](https://emerladcompass.github.io/BioShield/) • [🚀 Quick Start](#-quick-start) • [📦 PyPI Package](https://pypi.org/project/bioshield/) • [📊 Features](#-features) • [📚 Citation](#-how-to-cite) --- ## 🌱 Overview **BioShield v3.3.5** is a full-featured soil monitoring and auto-adjustment system designed for **Termux, Linux, and cross-platform deployment**. It integrates **sensor readings, AI analytics, auto-correction, alerts, dashboards, and reporting** into a **modular architecture** ready for production and research deployment. ### 🎯 Key Highlights | Feature | BioShield v3.3.5 | Previous Versions | Improvement | |---------|-----------------|-----------------|-------------| | **PyPI Package** | ✅ `pip install bioshield` | Manual installation | Automated distribution | | **Auto-Publishing** | ✅ GitHub Actions + Trusted Publishers | Manual upload | Full CI/CD pipeline | | **CLI Commands** | ✅ `bioshield` & `bs-adjust` | Python scripts only | Native system integration | | **Sensors Monitored** | pH, moisture, temperature, nutrients | pH, moisture | +2 parameters | | **AI Auto-Adjustment** | Yes, real-time | Partial / manual | Full automation | | **Cross-Platform** | Termux, Linux, Windows, macOS | Termux only | Universal compatibility | | **Modular Design** | 13+ interchangeable modules | Monolithic | Scalable architecture | --- ## 🚀 Quick Start ### Method 1: Install from PyPI (Recommended) ```bash # Basic installation pip install bioshield # With full features (desktop) pip install "bioshield[full]" # For development pip install "bioshield[dev]" Method 2: Clone from GitHub # Clone the repository git clone https://github.com/emerladcompass/BioShield.git cd BioShield/B_Agro_Immunity # Install in development mode pip install -e . # Or install requirements directly pip install -r requirements.txt Running the System # Full system (5 monitoring cycles) bioshield # Auto-adjustment only bs-adjust # Intensive adjustment session python run_intensive_adjust.py 📦 Installation On Termux (Android) # Install system packages pkg update && pkg upgrade pkg install python python-pandas python-numpy # Install BioShield pip install bioshield # Run the system bioshield On Desktop (Linux/macOS/Windows) # Install with all features pip install "bioshield[full]" # Or basic installation pip install bioshield Using Docker # Build the image docker build -t bioshield:latest . # Run container docker run -it --rm bioshield:latest 📊 Features 🔬 Core Modules · Soil Monitoring – Real-time pH, moisture, temperature tracking · AI Auto-Adjustment – Automatic irrigation and pH correction · Predictive Analytics – Forecast soil health trends · Report Generator – Daily, weekly, and summary reports · Live Dashboard – Interactive visualization interface · Directory Manager – Organized logs, reports, and data structure · Network Analyzer – Environmental interaction modeling 🏗️ Project Structure BioShield/ ├── src/ │ ├── main.py # CLI entry point │ ├── run_auto_adjust.py # Auto-adjustment system │ ├── __init__.py # Package definition │ ├── core_engine/ # AI engine │ │ ├── agro_immunity_engine.py │ │ └── engine.py │ ├── modules/ # 13 functional modules │ │ ├── soil_monitor.py │ │ ├── auto_adjuster.py │ │ ├── ai_predictor.py │ │ ├── report_generator.py │ │ ├── live_dashboard.py │ │ ├── nutrient_monitor.py │ │ ├── water_monitor.py │ │ ├── genomic_integrity.py │ │ └── ... (6 more modules) │ └── network/ │ └── network_analyzer.py ├── config.json ├── setup.py ├── requirements.txt ├── README.md ├── LICENSE └── .github/workflows/publish.yml # Auto-publishing 🌿 Applications · Agricultural Management: Soil optimization and irrigation control · Environmental Monitoring: Soil health and nutrient tracking · Predictive Analytics: Forecast trends for crops and land · Research Platform: Modular AI system for soil science · Mobile Deployment: Termux-ready for field operations · Educational Tool: Teaching AI applications in agriculture 🔄 Automated Publishing BioShield uses GitHub Actions with PyPI Trusted Publishers for automatic releases: Publishing Workflow: Create new version: Update setup.py version Create Git tag: git tag v3.3.6 Push tag: git push origin v3.3.6 GitHub Actions automatically: · ✅ Builds package (wheel + source) · ✅ Runs tests on Python 3.8-3.11 · ✅ Publishes to PyPI via Trusted Publishers · ✅ Creates GitHub Release with artifacts Trusted Publishers Configuration: · PyPI Project: bioshield · GitHub Owner: emerladcompass · Repository: BioShield · Workflow: publish.yml · Environment: pypi 📚 How to Cite If you use BioShield in your research, please cite: @software{baladi2026bioshield, author = {Baladi, Samir}, title = {{BioShield v3.3.5: Intelligent Soil Monitoring & Auto-Adjustment System}}, year = 2026, month = jan, publisher = {Zenodo}, version = {3.3.5}, doi = {10.5281/zenodo.18224754}, url = {https://doi.org/10.5281/zenodo.18224754} } DOI: 10.5281/zenodo.18224754 🤝 Contributing We welcome contributions! Here's how you can help: Ways to Contribute: Report Bugs – Open issues on GitHub Issues Suggest Features – Propose new modules or improvements Improve Documentation – Enhance guides and examples Validate Algorithms – Test AI predictions with real data Add Translations – Help translate to other languages Development Setup: # Fork and clone git clone https://github.com/YOUR_USERNAME/BioShield.git cd BioShield/B_Agro_Immunity # Install in development mode pip install -e ".[dev]" # Run tests pytest tests/ 📄 License This project is licensed under the MIT License - see the LICENSE file for details. Permissions: · ✅ Commercial use · ✅ Modification · ✅ Distribution · ✅ Private use · ✅ Patent use · ✅ Sublicensing Limitations: · ❌ Liability · ❌ Warranty Conditions: · © Must include copyright and license notice 👤 Author & Contact Samir Baladi Emerald Compass Research 🧭 · 📧 Email: emerladcompass@gmail.com · 🐙 GitHub: @emerladcompass · 🔬 ORCID: 0009-0003-8903-0029 · 🌐 Website: emerladcompass.github.io/bioshield · 📊 Live Dashboard: bioshield-b1.netlify.app Affiliations · Interdisciplinary AI Researcher · Open Source Contributor · Environmental Informatics Specialist 🔗 Quick Links · 🌐 PyPI Package: https://pypi.org/project/bioshield/ · 📖 Documentation: https://emerladcompass.github.io/BioShield/ · 🐙 Source Code: https://github.com/emerladcompass/BioShield · 📊 Dashboard: https://bioshield-b1.netlify.app · 📝 Issue Tracker: https://github.com/emerladcompass/BioShield/issues · 📚 Wiki: https://github.com/emerladcompass/BioShield/wiki BioShield v3.3.5 | Released January 2026 | MIT License "AI-powered soil monitoring. Real-time alerts. Predictive insights." ⬆ Back to Top ```