smartplant
v0.2.1
Published
A library for managing plant care with alerts and multi-language support.
Maintainers
Readme
Smartplant by PIGEONPOSSE
Smartplant is a library designed to simplify plant care through the integration of advanced artificial intelligence models. This technology not only researches detailed information about each type of plant but also determines the optimal conditions for their care, thereby maximizing their growth and health. Thanks to this functionality, users can efficiently monitor and manage the environment of their plants using sensors that measure humidity, light, and temperature.
The core idea behind SmartPlant is to pave the way for advancements in plant care technology. It serves as a foundation for developing more sophisticated solutions and experimenting with innovative devices that meet the needs of plants. By leveraging this library, developers can contribute to the evolution of the smart plant care ecosystem.
Features
🧠 Multi-Model AI Engine
The heart of SmartPlant now supports the world's most powerful LLMs to analyze your plant's health:
- Cloud Power: OpenAI (GPT-4), xAI (Grok), Anthropic (Claude), and Google (Gemini).
- Privacy First: Full support for Ollama to run models locally.
- Smart Optimization: AI-driven care routines tailored to each specific species.
🛠 Hardware & Monitoring
- 📊 Real-Time Monitoring: High-precision tracking of humidity, light, and temperature.
- 🔔 Customized Alerts: Immediate notifications for critical environmental changes.
- 📈 Data History: Trend analysis to visualize your plant's growth over time.
- 🔮 Predictive Health: AI forecasting to prevent stress before it happens.
- 🔌 Plugin Ecosystem: Modular architecture with built-in tests for easy feature expansion.
Plugins
Extend SmartPlant's core with specialized modules for automation and AI analysis. Each plugin features a built-in test to verify performance.
💧 Watering: AI predictive watering based on DHT22 data. |
@smartplant/watering😟 Stress: Detects early signs of environmental stress. |
@smartplant/stress☀️ Lighting: Optimizes LED cycles and light intensity.
@smartplant/lighting📈 History: Analyzes and visualizes long-term growth trends. |
@smartplant/history⚠️ Alerts: Species-specific safety range notifications. |
@smartplant/alerts🌱 Fertilizer: Sensor-guided nutrient and feeding schedules. |
@smartplant/fertilizer🐛 Pests: Identifies pest risks and organic treatments. |
@smartplant/pests💨 Ventilation: Smart airflow and condensation control. |
@smartplant/ventilation📔 Diary: Interactive logs with AI health summaries. |
@smartplant/diary🤩 Simulator: Forecasts plant reactions to environment changes. | `@smartplant/simulator``
Installation
To install the library, use npm:
npm install -g smartplantBenefits of the emojis system
This approach with emojis provides a simplified and visually attractive user experience.It allows even those without deep technical knowledge to quickly understand the state of the plant and take the necessary measures.It is a way to offer immediate and clear feedback, improving interaction with the system and promoting more regular and careful maintenance of the plant.
Emojis scales for parameter monitoring
To make the plant monitoring more intuitive and visually accessible, we have implemented an emojis system that represents different levels of each critical parameter: moisture, light and temperature.Each emoji offers a rapid representation of the current status of the parameter, which facilitates interpretation without analyzing specific numbers.
Humidity
- 🍂 Very dry: Indicates that moisture is below the recommended minimum range.The plant is at risk of dehydration.
- 🌿 Ideal: Moisture is within the ideal range, which means that the plant is in optimal conditions.
- 💧 Slightly wet: Indicates that moisture is slightly above the ideal range, but it is not yet worrisome.
- 🌊 Very humid: Moisture is above the maximum allowed range, which could lead to saturation and problems such as waterlogging.
Light
- 🌑 Very little light: points out that the plant receives less light than necessary, which could affect its growth.
- 🌥 Ideal: The plant receives the amount of light adequate for healthy development.
- 🌞 Too much light: Light exposure is excessive, which can cause burns or stress in the plant.
Temperature
- 🧊 Very cold: The temperature is below the minimum range, which can slow down or damage the plant.
- 🌡️ Ideal: The temperature is in the optimal range for the growth and development of the plant.
- 🔥 Very hot: The temperature exceeds the maximum range, which could cause overheating and dehydration.
Emojis-based happiness system
In addition to the specific parameters, we have designed a system of general happiness for the plant, which is represented with caritas emojis.This system provides a global vision of the state of the plant, based on a combination of its levels of humidity, light and temperature.
Happiness scale
- 🤩 Very happy: The plant is in ideal conditions in all key parameters.This is the optimal state.
- 😊 Happy: The plant is in good condition, although there could be slight deviations in some parameters.
- 😐 Acceptable: The plant is in acceptable conditions, but is far from ideal.Small adjustments may be required.
- 😞 Bad conditions: The plant is experiencing unfavorable conditions and needs attention to avoid major damage.
- 😖 Critical conditions: The plant is in a critical state and requires immediate action to prevent its condition will get worse.
- 🥵 Extremely critical: The plant is in an extremely critical state and is in danger of dying if urgent measures are not taken.
- 😵 No Data Detected: Vital signals missing or sensors not transmitting requiring immediate check.
☕ Donate
Help us to develop more interesting things.
📜 License
This software is licensed with GPL-3.0.
🐦 About us
PigeonPosse is a ✨ code development collective ✨ focused on creating practical and interesting tools that help developers and users enjoy a more agile and comfortable experience. Our projects cover various programming sectors and we do not have a thematic limitation in terms of projects.
Collaborators
| | Name | Role | GitHub | | ---------------------------------------------------------------------------------- | ----------- | ------------ | ---------------------------------------------- | | | Alejo | Author & Development | @alejomalia | | | PigeonPosse | Collective | @PigeonPosse |

