Release v2.0.0-alpha

.github/workflows/validate.yaml

@@ -0,0 +1,17 @@
+name: Validate
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+jobs:
+  validate-hacs:
+    runs-on: "ubuntu-latest"
+    steps:
+      - name: HACS validation
+        uses: "hacs/action@main"
+        with:
+          category: "integration"

README.md

@@ -2,7 +2,7 @@
 
 <div align="center">  
 
-  ![GitHub release](https://img.shields.io/github/release/smkrv/ha-text-ai.svg?style=flat-square) ![GitHub downloads](https://img.shields.io/github/downloads/smkrv/ha-text-ai/total.svg?style=flat-square) ![GitHub stars](https://img.shields.io/github/stars/smkrv/ha-text-ai.svg?style=social) ![GitHub last commit](https://img.shields.io/github/last-commit/smkrv/ha-text-ai.svg?style=flat-square) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT) [![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=flat-square)](https://github.com/hacs/integration)
+![GitHub release](https://img.shields.io/github/release/smkrv/ha-text-ai.svg?style=flat-square) ![GitHub downloads](https://img.shields.io/github/downloads/smkrv/ha-text-ai/total.svg?style=flat-square) ![GitHub stars](https://img.shields.io/github/stars/smkrv/ha-text-ai.svg?style=social) ![GitHub last commit](https://img.shields.io/github/last-commit/smkrv/ha-text-ai.svg?style=flat-square) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT) [![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=flat-square)](https://github.com/hacs/integration)
 
   <img src="https://github.com/smkrv/ha-text-ai/blob/3e3ec45b195c92989434fde40ae110027f4ea124/misc/icons/icon.png" alt="HA Text AI" width="140"/>
 
@@ -11,13 +11,17 @@
 
 <p align="center">
 Transform your smart home experience with powerful AI assistance powered by multiple AI providers including OpenAI GPT and Anthropic Claude models. Get intelligent responses, automate complex scenarios, and enhance your home automation with advanced natural language processing.
+
 </p>
 
 ---
-> [!NOTE]
+
+> [!IMPORTANT]
 > 🚧 ALPHA VERSION 🚧  
-> Expect: potential bugs, frequent changes, incomplete features.
-> 🤝 Community Driven
+> Expect: potential bugs, frequent changes, incomplete features.  
+> 🤝 Community Driven  
+>
+>  <a href="https://community.home-assistant.io/t/ha-text-ai-transforming-home-automation-with-multi-provider-language-models/799741"><img src="https://img.shields.io/badge/Community-blue?style=for-the-badge&logo=homeassistant&logoColor=white&color=03a9f4"/></a>  
 
 ## 🌟 Features
 
@@ -192,6 +196,107 @@ data:
   filter_model: "gpt-4o"  # optional
 ```
 
+### 🏷️ HA Text AI Sensor Naming Convention
+
+#### Sensor Name Structure
+```yaml
+# Always starts with 'sensor.ha_text_ai_'
+# You define only the part after the underscore
+sensor.ha_text_ai_YOUR_UNIQUE_SUFFIX
+
+# Examples:
+sensor.ha_text_ai_gpt      # GPT-based sensor
+sensor.ha_text_ai_claude   # Claude-based sensor
+sensor.ha_text_ai_gpt   # Custom suffix
+```
+
+#### Response Retrieval
+```yaml
+# Use your specific sensor name
+{{ state_attr('sensor.ha_text_ai_gpt', 'response') }}
+```
+
+#### Practical Usage
+```yaml
+automation:
+  - alias: "AI Response with Custom Sensor"
+    action:
+      - service: ha_text_ai.ask_question
+        data:
+          question: "Home automation advice"
+      - service: notify.mobile
+        data:
+          message: >
+            AI Tip:
+            {{ state_attr('sensor.ha_text_ai_gpt', 'response') }}
+```
+
+### 💡 Naming Rules
+- Prefix is always `sensor.ha_text_ai_`
+- Add your unique identifier after the underscore
+- Use lowercase
+- No spaces allowed
+- Keep it descriptive but concise
+
+### 🔍 HA Text AI Sensor Attributes
+
+#### Model and Provider Information
+```yaml
+# Model details
+{{ state_attr('sensor.ha_text_ai_gpt', 'Model') }}           # gpt-4o
+{{ state_attr('sensor.ha_text_ai_gpt', 'Api provider') }}    # openai
+{{ state_attr('sensor.ha_text_ai_gpt', 'Last model') }}      # gpt-4o
+```
+
+#### System Status
+```yaml
+# Operational status
+{{ state_attr('sensor.ha_text_ai_gpt', 'Api status') }}      # ready
+{{ state_attr('sensor.ha_text_ai_gpt', 'Is processing') }}   # false
+{{ state_attr('sensor.ha_text_ai_gpt', 'Is rate limited') }} # false
+{{ state_attr('sensor.ha_text_ai_gpt', 'Endpoint status') }} # ready
+```
+
+#### Performance Metrics
+```yaml
+# Request and performance statistics
+{{ state_attr('sensor.ha_text_ai_gpt', 'Successful requests') }}   # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Failed requests') }}       # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Average latency') }}       # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Max latency') }}           # 0
+```
+
+#### Conversation and Token Usage
+```yaml
+# Conversation and token details
+{{ state_attr('sensor.ha_text_ai_gpt', 'History size') }}          # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Total tokens') }}          # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Prompt tokens') }}         # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Completion tokens') }}     # 0
+```
+
+#### Last Interaction Details
+```yaml
+# Last interaction information
+{{ state_attr('sensor.ha_text_ai_gpt', 'Response') }}        # Last AI response
+{{ state_attr('sensor.ha_text_ai_gpt', 'Question') }}        # Last asked question
+{{ state_attr('sensor.ha_text_ai_gpt', 'Last timestamp') }}  # Timestamp
+```
+
+#### System Health
+```yaml
+# System health and maintenance
+{{ state_attr('sensor.ha_text_ai_gpt', 'Total errors') }}    # 0
+{{ state_attr('sensor.ha_text_ai_gpt', 'Is maintenance') }}  # false
+{{ state_attr('sensor.ha_text_ai_gpt', 'Uptime') }}          # 547,58
+```
+
+### 💡 Pro Tips
+- Always check attribute existence
+- Use these attributes for monitoring and automation
+- Some values might be 0 or empty initially
+
+
 ## 📘 FAQ
 
 **Q: Which AI providers are supported?**
@@ -232,11 +337,27 @@ Contributions welcome! Please read our [Contributing Guide](CONTRIBUTING.md).
 
 MIT License - see [LICENSE](LICENSE) for details.
 
+## 💡 Support the Project
+
+The best support is:
+- Sharing feedback
+- Contributing ideas
+- Recommending to friends
+- Reporting issues
+- Star the repository
+
+If you want to say thanks financially, you can send a small token of appreciation in USDT:
+
+**USDT Wallet (TRC10/TRC20):**
+`TXC9zYHYPfWUGi4Sv4R1ctTBGScXXQk5HZ`
+
+*Open-source is built by community passion!* 🚀
+
 ---
 
 <div align="center">
 
-Made with ❤️ for the Home Assistant Community
+Made with ❤️ and Claude 3.5 Sonnet for the Home Assistant Community
 
 [Report Bug](https://github.com/smkrv/ha-text-ai/issues) · [Request Feature](https://github.com/smkrv/ha-text-ai/issues)
 

custom_components/ha_text_ai/__init__.py

@@ -89,7 +89,7 @@ async def async_setup(hass: HomeAssistant, config: Dict[str, Any]) -> bool:
         source = os.path.join(os.path.dirname(__file__), 'icons', 'icon.svg')
         dest_dir = os.path.join(hass.config.path('www'), 'icons')
         os.makedirs(dest_dir, exist_ok=True)
-        dest = os.path.join(dest_dir, 'icon.svg')
+        dest = os.path.join(dest_dir, 'icon.png')
         if not os.path.exists(dest):
             shutil.copyfile(source, dest)
     except Exception as ex:

custom_components/ha_text_ai/manifest.json

@@ -23,6 +23,6 @@
   "single_config_entry": false,
   "ssdp": [],
   "usb": [],
-  "version": "2.0.0",
+  "version": "2.0.0-alpha",
   "zeroconf": []
 }

hacs.json

@@ -1,9 +1,5 @@
 {
   "name": "HA text AI",
   "render_readme": true,
-  "icon": "mdi:robot",
-  "domains": ["sensor"],
-  "homeassistant": "2024.11.0",
-  "version": "2.0.0",
-  "documentation": "https://github.com/smkrv/ha-text-ai"
+  "homeassistant": "2024.11.0"
 }

structure.md

@@ -2,18 +2,24 @@
 ha-text-ai/
 │
 ├── custom_components/
-│   └── ha_text_ai/
-│       ├── __init__.py
-│       ├── config_flow.py
-│       ├── coordinator.py
-│       ├── manifest.json
-│       ├── sensor.py
-│       ├── services.yaml
-│       ├── const.py
-│       └── api_client.py
-│
-└── strings/
-    ├── en.json
-    ├── de.json
-    └── ru.json
+    ├── ha_text_ai/
+    │   ├── __init__.py
+    │   ├── config_flow.py
+    │   ├── coordinator.py
+    │   ├── manifest.json
+    │   ├── sensor.py
+    │   ├── services.yaml
+    │   ├── const.py
+    │   └── api_client.py
+    │
+    ├── translations/
+    │   ├── en.json
+    │   ├── de.json
+    │   └── ru.json
+    │
+    └── icons/
+        ├── icon.png
+        ├── icon@2x.png
+        ├── logo.png
+        └── logo@2x.png
 ```