Release v2.0.4-beta

- Added translations for:
  * Chinese (zh)
  * Serbian (sr)
  * Italian (it)
  * Hindi (hi)
  * Spanish (es)

- Fixed minor bugs
- Improved language coverage

.github/ISSUE_TEMPLATE/bug_report.md

@@ -3,7 +3,7 @@ name: Bug report
 about: Create a report to help us improve
 title: ''
 labels: bug
-assignees: ''
+assignees: '' 
 
 ---
 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -3,7 +3,7 @@ name: Feature request
 about: Suggest an idea for this project
 title: ''
 labels: enhancement
-assignees: ''
+assignees: '' 
 
 ---
 

.gitignore

@@ -37,3 +37,4 @@ wheels/
 Thumbs.db
 *.psd
 *.zip
+*.txt

CONTRIBUTING.md

@@ -21,7 +21,7 @@ We welcome contributions to the HA Text AI project! This document will help you
    git remote add upstream https://github.com/smkrv/ha-text-ai.git
    ```
 
-### 2. Creating a Development Branch
+### 2. Creating a Development Branch 
 
 ```bash
 # Update the main branch

LICENSE

@@ -1,22 +1,437 @@
-MIT License
+Attribution-NonCommercial-ShareAlike 4.0 International
 
-Copyright (c) 2024 smkrv
+=======================================================================
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
+Creative Commons Corporation ("Creative Commons") is not a law firm and
-of this software and associated documentation files (the "Software"), to deal
+does not provide legal services or legal advice. Distribution of
-in the Software without restriction, including without limitation the rights
+Creative Commons public licenses does not create a lawyer-client or
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+other relationship. Creative Commons makes its licenses and related
-copies of the Software, and to permit persons to whom the Software is
+information available on an "as-is" basis. Creative Commons gives no
-furnished to do so, subject to the following conditions:
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
 
-The above copyright notice and this permission notice shall be included in all
+Using Creative Commons Public Licenses
-copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+Creative Commons public licenses provide a standard set of terms and
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+conditions that creators and other rights holders may use to share
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+original works of authorship and other material subject to copyright
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+and certain other rights specified in the public license below. The
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+following considerations are for informational purposes only, are not
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+exhaustive, and do not form part of our licenses.
-SOFTWARE.
+
- 
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution-NonCommercial-ShareAlike 4.0 International Public License
+("Public License"). To the extent this Public License may be
+interpreted as a contract, You are granted the Licensed Rights in
+consideration of Your acceptance of these terms and conditions, and the
+Licensor grants You such rights in consideration of benefits the
+Licensor receives from making the Licensed Material available under
+these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. BY-NC-SA Compatible License means a license listed at
+     creativecommons.org/compatiblelicenses, approved by Creative
+     Commons as essentially the equivalent of this Public License.
+
+  d. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  e. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  f. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  g. License Elements means the license attributes listed in the name
+     of a Creative Commons Public License. The License Elements of this
+     Public License are Attribution, NonCommercial, and ShareAlike.
+
+  h. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  i. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  j. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  k. NonCommercial means not primarily intended for or directed towards
+     commercial advantage or monetary compensation. For purposes of
+     this Public License, the exchange of the Licensed Material for
+     other material subject to Copyright and Similar Rights by digital
+     file-sharing or similar means is NonCommercial provided there is
+     no payment of monetary compensation in connection with the
+     exchange.
+
+  l. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  m. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  n. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part, for NonCommercial purposes only; and
+
+            b. produce, reproduce, and Share Adapted Material for
+               NonCommercial purposes only.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. Additional offer from the Licensor -- Adapted Material.
+               Every recipient of Adapted Material from You
+               automatically receives an offer from the Licensor to
+               exercise the Licensed Rights in the Adapted Material
+               under the conditions of the Adapter's License You apply.
+
+            c. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties, including when
+          the Licensed Material is used other than for NonCommercial
+          purposes.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+  b. ShareAlike.
+
+     In addition to the conditions in Section 3(a), if You Share
+     Adapted Material You produce, the following conditions also apply.
+
+       1. The Adapter's License You apply must be a Creative Commons
+          license with the same License Elements, this version or
+          later, or a BY-NC-SA Compatible License.
+
+       2. You must include the text of, or the URI or hyperlink to, the
+          Adapter's License You apply. You may satisfy this condition
+          in any reasonable manner based on the medium, means, and
+          context in which You Share Adapted Material.
+
+       3. You may not offer or impose any additional or different terms
+          or conditions on, or apply any Effective Technological
+          Measures to, Adapted Material that restrict exercise of the
+          rights granted under the Adapter's License You apply.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database for NonCommercial purposes
+     only;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material,
+     including for purposes of Section 3(b); and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.

README.md

@@ -6,7 +6,7 @@
 
   <img src="https://github.com/smkrv/ha-text-ai/blob/524849f6a945ec62c2cf6a6b7ecd9a28b37bf0fa/misc/icons/logo.jpg" alt="HA Text AI" height="160"/>
 
-### Advanced AI Integration for Home Assistant with LLM multi-provider support
+### Advanced AI Integration for [Home Assistant](https://www.home-assistant.io/) with LLM multi-provider support
 </div>
 
 <p align="center">
@@ -22,6 +22,8 @@ Transform your smart home experience with powerful AI assistance powered by mult
 > 🤝 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>  
+>  
+> [Screenshots](misc/screenshots/screenshot.jpg)
 
 ## 🌟 Features
 
@@ -243,7 +245,7 @@ data:
 - Only lowercase letters (a-z)  
 - Numbers (0-9)  
 - Underscore (_)  
-- Maximum length: 50 characters (including `ha_text_ai_` prefix (14 characters)
+- Maximum length: 50 characters (including `ha_text_ai_`)
 
 #### Sensor Name Structure
 ```yaml
@@ -410,9 +412,23 @@ Contributions welcome! Please read our [Contributing Guide](CONTRIBUTING.md).
 4. Push branch (`git push origin feature/Enhancement`)
 5. Open Pull Request
 
+## Legal Disclaimer and Limitation of Liability  
+
+### Software Disclaimer  
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,   
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A   
+PARTICULAR PURPOSE AND NONINFRINGEMENT.  
+
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,   
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER   
+DEALINGS IN THE SOFTWARE.  
+
 ## 📝 License
 
-MIT License - see [LICENSE](LICENSE) for details.
+Author: SMKRV
+[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) - see [LICENSE](LICENSE) for details. 
 
 ## 💡 Support the Project
 

custom_components/ha_text_ai/__init__.py

@@ -1,4 +1,11 @@
-"""The HA Text AI integration."""
+"""
+The HA Text AI integration.
+
+@license: CC BY-NC-SA 4.0 International
+@author: SMKRV
+@github: https://github.com/smkrv/ha-text-ai
+@source: https://github.com/smkrv/ha-text-ai
+"""
 from __future__ import annotations
 
 import logging

custom_components/ha_text_ai/api_client.py

@@ -1,4 +1,11 @@
-"""API Client for HA Text AI."""
+"""
+API Client for HA Text AI.
+
+@license: CC BY-NC-SA 4.0 International
+@author: SMKRV
+@github: https://github.com/smkrv/ha-text-ai
+@source: https://github.com/smkrv/ha-text-ai
+"""
 import logging
 import asyncio
 from typing import Any, Dict, List, Optional
@@ -106,6 +113,11 @@ class APIClient:
                 return await self._create_openai_completion(
                     model, messages, temperature, max_tokens
                 )
+        except (KeyError, IndexError) as e:
+            if "'choices'" in str(e) or "'message'" in str(e):
+                raise HomeAssistantError("Failed to get a response from the AI model. Please check your internet connection and try again later.")
+            else:
+                raise
         except Exception as e:
             _LOGGER.error("API request failed: %s", str(e))
             raise HomeAssistantError(f"API request failed: {str(e)}")

custom_components/ha_text_ai/config_flow.py

@@ -1,4 +1,11 @@
-"""Config flow for HA text AI integration."""
+"""
+Config flow for HA text AI integration.
+
+@license: CC BY-NC-SA 4.0 International
+@author: SMKRV
+@github: https://github.com/smkrv/ha-text-ai
+@source: https://github.com/smkrv/ha-text-ai
+"""
 import logging
 from typing import Any, Dict, Optional
 

custom_components/ha_text_ai/const.py

@@ -1,4 +1,11 @@
-"""Constants for the HA text AI integration."""
+"""
+Constants for the HA text AI integration.
+
+@license: CC BY-NC-SA 4.0 International
+@author: SMKRV
+@github: https://github.com/smkrv/ha-text-ai
+@source: https://github.com/smkrv/ha-text-ai
+"""
 from typing import Final
 import voluptuous as vol
 from homeassistant.const import Platform, CONF_API_KEY, CONF_NAME

custom_components/ha_text_ai/coordinator.py

@@ -1,4 +1,11 @@
-"""The HA Text AI coordinator."""
+"""
+The HA Text AI coordinator.
+
+@license: CC BY-NC-SA 4.0 International
+@author: SMKRV
+@github: https://github.com/smkrv/ha-text-ai
+@source: https://github.com/smkrv/ha-text-ai
+"""
 from __future__ import annotations
 
 import logging
@@ -11,7 +18,7 @@ from homeassistant.helpers.update_coordinator import DataUpdateCoordinator
 from homeassistant.util import dt as dt_util
 from homeassistant.exceptions import HomeAssistantError
 from homeassistant.const import CONF_NAME
-from .config_flow import normalize_name 
+from .config_flow import normalize_name
 
 from .const import (
     DOMAIN,

custom_components/ha_text_ai/manifest.json

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

custom_components/ha_text_ai/sensor.py

@@ -1,4 +1,11 @@
-"""Sensor platform for HA Text AI."""
+"""
+Sensor platform for HA Text AI.
+
+@license: CC BY-NC-SA 4.0 International
+@author: SMKRV
+@github: https://github.com/smkrv/ha-text-ai
+@source: https://github.com/smkrv/ha-text-ai
+"""
 import logging
 import math
 from typing import Any, Dict

custom_components/ha_text_ai/translations/es.json

@@ -0,0 +1,266 @@
+{
+  "config": {
+    "step": {
+      "provider": {
+        "title": "Seleccionar proveedor de IA",
+        "description": "Elige qué proveedor de servicios de IA usar para esta instancia.",
+        "data": {
+          "api_provider": "Proveedor de API",
+          "context_messages": "Número de mensajes de contexto que conservar (1-20)"
+        }
+      },
+      "user": {
+        "title": "Configurar instancia de HA Text AI",
+        "description": "Configura una nueva instancia de asistente de IA con el proveedor seleccionado.",
+        "data": {
+          "name": "Nombre de la instancia (p. ej., 'Asistente GPT', 'Ayudante de Claude')",
+          "api_key": "Clave API para la autenticación",
+          "model": "Modelo de IA a usar",
+          "temperature": "Creatividad de la respuesta (0-2, cuanto menor, más enfocada)",
+          "max_tokens": "Longitud máxima de la respuesta (1-4096 tokens)",
+          "api_endpoint": "URL del punto final de la API personalizada (opcional)",
+          "api_provider": "Proveedor de API",
+          "request_interval": "Tiempo mínimo entre solicitudes (0,1-60 segundos)",
+          "context_messages": "Número de mensajes de contexto que conservar (1-20)",
+          "max_history_size": "Tamaño máximo del historial de conversación (1-100)"
+        }
+      }
+    },
+    "error": {
+      "name_exists": "Ya existe una instancia con este nombre",
+      "invalid_name": "Nombre de instancia no válido",
+      "invalid_auth": "Error de autenticación: comprueba tu clave API",
+      "invalid_api_key": "Clave API no válida: verifica tus credenciales",
+      "cannot_connect": "No se pudo conectar al servicio API",
+      "invalid_model": "El modelo seleccionado no está disponible",
+      "rate_limit": "Límite de tasa excedido",
+      "context_length": "Longitud de contexto excedida",
+      "rate_limit_exceeded": "Límite de tasa de API excedido",
+      "maintenance": "El servicio está en mantenimiento",
+      "invalid_response": "Se recibió una respuesta de API no válida",
+      "api_error": "Se produjo un error en el servicio API",
+      "timeout": "Tiempo de espera de la solicitud agotado",
+      "invalid_instance": "Instancia especificada no válida",
+      "unknown": "Se produjo un error inesperado",
+      "empty": "El nombre no puede estar vacío",
+      "invalid_characters": "El nombre solo puede contener letras, números, espacios, guiones bajos y guiones",
+      "name_too_long": "El nombre debe tener 50 caracteres o menos"
+    }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "Actualizar configuración de la instancia",
+        "description": "Modifica la configuración de esta instancia de asistente de IA.",
+        "data": {
+          "model": "Modelo de IA",
+          "temperature": "Creatividad de la respuesta (0-2)",
+          "max_tokens": "Longitud máxima de la respuesta (1-4096)",
+          "request_interval": "Intervalo mínimo de solicitud (0,1-60 segundos)",
+          "context_messages": "Número de mensajes anteriores que se incluirán en el contexto (1-20)",
+          "max_history_size": "Tamaño máximo del historial de conversación (1-100)"
+        }
+      }
+    }
+  },
+  "services": {
+    "ask_question": {
+      "name": "Hacer pregunta (HA Text AI)",
+      "description": "Envía una pregunta al modelo de IA y recibe una respuesta detallada. La respuesta se almacenará en el historial de conversación y se podrá recuperar más tarde.",
+      "fields": {
+        "instance": {
+          "name": "Instancia",
+          "description": "Nombre de la instancia de HA Text AI a utilizar"
+        },
+        "question": {
+          "name": "Pregunta",
+          "description": "Tu pregunta o indicación para el asistente de IA"
+        },
+        "context_messages": {
+          "name": "Mensajes de contexto",
+          "description": "Número de mensajes anteriores que se incluirán en el contexto (1-20)"
+        },
+        "system_prompt": {
+          "name": "Indicación del sistema",
+          "description": "Indicación del sistema opcional para establecer el contexto de esta pregunta específica"
+        },
+        "model": {
+          "name": "Modelo",
+          "description": "Selecciona el modelo de IA que se va a utilizar (opcional, anula la configuración predeterminada)"
+        },
+        "temperature": {
+          "name": "Temperatura",
+          "description": "Controla la creatividad de la respuesta (0.0-2.0)"
+        },
+        "max_tokens": {
+          "name": "Máx. tokens",
+          "description": "Longitud máxima de la respuesta (1-4096 tokens)"
+        }
+      }
+    },
+    "clear_history": {
+      "name": "Borrar historial",
+      "description": "Elimina todas las preguntas y respuestas almacenadas del historial de conversación",
+      "fields": {
+        "instance": {
+          "name": "Instancia",
+          "description": "Nombre de la instancia de HA Text AI para la que se va a borrar el historial"
+        }
+      }
+    },
+    "get_history": {
+      "name": "Obtener historial",
+      "description": "Recupera el historial de conversaciones con filtrado y ordenación opcionales",
+      "fields": {
+        "instance": {
+          "name": "Instancia",
+          "description": "Nombre de la instancia de HA Text AI de la que se va a obtener el historial"
+        },
+        "limit": {
+          "name": "Límite",
+          "description": "Número de conversaciones que se van a devolver (1-100)"
+        },
+        "filter_model": {
+          "name": "Filtrar modelo",
+          "description": "Filtra las conversaciones por un modelo de IA específico"
+        },
+        "start_date": {
+          "name": "Fecha de inicio",
+          "description": "Filtra las conversaciones a partir de esta fecha/hora"
+        },
+        "include_metadata": {
+          "name": "Incluir metadatos",
+          "description": "Incluir información adicional como los tokens utilizados, el tiempo de respuesta, etc."
+        },
+        "sort_order": {
+          "name": "Orden de clasificación",
+          "description": "Orden de clasificación de los resultados (más recientes o más antiguos primero)"
+        }
+      }
+    },
+    "set_system_prompt": {
+      "name": "Establecer indicación del sistema",
+      "description": "Establece instrucciones predeterminadas de comportamiento del sistema para todas las conversaciones futuras",
+      "fields": {
+        "instance": {
+          "name": "Instancia",
+          "description": "Nombre de la instancia de HA Text AI para la que se va a establecer la indicación del sistema"
+        },
+        "prompt": {
+          "name": "Indicación del sistema",
+          "description": "Instrucciones que definen cómo debe comportarse y responder la IA"
+        }
+      }
+    }
+  },
+  "entity": {
+    "sensor": {
+      "ha_text_ai": {
+        "name": "{name}",
+        "state": {
+          "ready": "Listo",
+          "processing": "Procesando",
+          "error": "Error",
+          "disconnected": "Desconectado",
+          "rate_limited": "Límite de tasa alcanzado",
+          "maintenance": "Mantenimiento",
+          "initializing": "Inicializando",
+          "retrying": "Reintentando",
+          "queued": "En cola"
+        },
+        "state_attributes": {
+          "question": {
+            "name": "Última pregunta"
+          },
+          "response": {
+            "name": "Última respuesta"
+          },
+          "model": {
+            "name": "Modelo actual"
+          },
+          "temperature": {
+            "name": "Temperatura"
+          },
+          "max_tokens": {
+            "name": "Máx. tokens"
+          },
+          "system_prompt": {
+            "name": "Indicación del sistema"
+          },
+          "response_time": {
+            "name": "Tiempo de la última respuesta"
+          },
+          "total_responses": {
+            "name": "Total de respuestas"
+          },
+          "error_count": {
+            "name": "Recuento de errores"
+          },
+          "last_error": {
+            "name": "Último error"
+          },
+          "api_status": {
+            "name": "Estado de la API"
+          },
+          "tokens_used": {
+            "name": "Total de tokens usados"
+          },
+          "average_response_time": {
+            "name": "Tiempo medio de respuesta"
+          },
+          "last_request_time": {
+            "name": "Tiempo de la última solicitud"
+          },
+          "is_processing": {
+            "name": "Estado de procesamiento"
+          },
+          "is_rate_limited": {
+            "name": "Estado de límite de tasa"
+          },
+          "is_maintenance": {
+            "name": "Estado de mantenimiento"
+          },
+          "api_version": {
+            "name": "Versión de la API"
+          },
+          "endpoint_status": {
+            "name": "Estado del punto final"
+          },
+          "performance_metrics": {
+            "name": "Métricas de rendimiento"
+          },
+          "history_size": {
+            "name": "Tamaño del historial"
+          },
+          "uptime": {
+            "name": "Tiempo de actividad"
+          },
+          "total_tokens": {
+            "name": "Total de tokens"
+          },
+          "prompt_tokens": {
+            "name": "Tokens de indicación"
+          },
+          "completion_tokens": {
+            "name": "Tokens de compleción"
+          },
+          "successful_requests": {
+            "name": "Solicitudes exitosas"
+          },
+          "failed_requests": {
+            "name": "Solicitudes fallidas"
+          },
+          "average_latency": {
+            "name": "Latencia media"
+          },
+          "max_latency": {
+            "name": "Latencia máxima"
+          },
+          "min_latency": {
+            "name": "Latencia mínima"
+          }
+        }
+      }
+    }
+  }
+}

custom_components/ha_text_ai/translations/hi.json

@@ -0,0 +1,266 @@
+{
+  "config": {
+    "step": {
+      "provider": {
+        "title": "AI प्रदाता का चयन करें",
+        "description": "इस उदाहरण के लिए उपयोग करने के लिए AI सेवा प्रदाता चुनें।",
+        "data": {
+          "api_provider": "API प्रदाता",
+          "context_messages": "बनाए रखने के लिए संदर्भ संदेशों की संख्या (1-20)"
+        }
+      },
+      "user": {
+        "title": "HA टेक्स्ट AI उदाहरण को कॉन्फ़िगर करें",
+        "description": "अपने चयनित प्रदाता के साथ एक नया AI सहायक उदाहरण सेट करें।",
+        "data": {
+          "name": "उदाहरण का नाम (जैसे, 'GPT सहायक', 'क्लाउड सहायक')",
+          "api_key": "प्रमाणीकरण के लिए API कुंजी",
+          "model": "उपयोग करने के लिए AI मॉडल",
+          "temperature": "प्रतिक्रिया रचनात्मकता (0-2, कम = अधिक केंद्रित)",
+          "max_tokens": "अधिकतम प्रतिक्रिया लंबाई (1-4096 टोकन)",
+          "api_endpoint": "कस्टम API एंडपॉइंट URL (वैकल्पिक)",
+          "api_provider": "API प्रदाता",
+          "request_interval": "अनुरोधों के बीच न्यूनतम समय (0.1-60 सेकंड)",
+          "context_messages": "बनाए रखने के लिए संदर्भ संदेशों की संख्या (1-20)",
+          "max_history_size": "अधिकतम वार्तालाप इतिहास आकार (1-100)"
+        }
+      }
+    },
+    "error": {
+      "name_exists": "इस नाम का एक उदाहरण पहले से मौजूद है",
+      "invalid_name": "अमान्य उदाहरण नाम",
+      "invalid_auth": "प्रमाणीकरण विफल - अपनी API कुंजी जांचें",
+      "invalid_api_key": "अमान्य API कुंजी - कृपया अपनी क्रेडेंशियल सत्यापित करें",
+      "cannot_connect": "API सेवा से कनेक्ट करने में विफल",
+      "invalid_model": "चयनित मॉडल उपलब्ध नहीं है",
+      "rate_limit": "दर सीमा पार हो गई",
+      "context_length": "संदर्भ लंबाई पार हो गई",
+      "rate_limit_exceeded": "API दर सीमा पार हो गई",
+      "maintenance": "सेवा रखरखाव के अधीन है",
+      "invalid_response": "अमान्य API प्रतिक्रिया प्राप्त हुई",
+      "api_error": "API सेवा त्रुटि हुई",
+      "timeout": "अनुरोध समय समाप्त हो गया",
+      "invalid_instance": "अमान्य उदाहरण निर्दिष्ट किया गया",
+      "unknown": "अप्रत्याशित त्रुटि हुई",
+      "empty": "नाम खाली नहीं हो सकता",
+      "invalid_characters": "नाम में केवल अक्षर, संख्या, रिक्त स्थान, अंडरस्कोर और हाइफ़न हो सकते हैं",
+      "name_too_long": "नाम 50 वर्ण या उससे कम होना चाहिए"
+    }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "उदाहरण सेटिंग्स अपडेट करें",
+        "description": "इस AI सहायक उदाहरण के लिए सेटिंग्स संशोधित करें।",
+        "data": {
+          "model": "AI मॉडल",
+          "temperature": "प्रतिक्रिया रचनात्मकता (0-2)",
+          "max_tokens": "अधिकतम प्रतिक्रिया लंबाई (1-4096)",
+          "request_interval": "न्यूनतम अनुरोध अंतराल (0.1-60 सेकंड)",
+          "context_messages": "संदर्भ में शामिल करने के लिए पिछले संदेशों की संख्या (1-20)",
+          "max_history_size": "अधिकतम वार्तालाप इतिहास आकार (1-100)"
+        }
+      }
+    }
+  },
+  "services": {
+    "ask_question": {
+      "name": "प्रश्न पूछें (HA टेक्स्ट AI)",
+      "description": "AI मॉडल को एक प्रश्न भेजें और एक विस्तृत प्रतिक्रिया प्राप्त करें। प्रतिक्रिया वार्तालाप इतिहास में संग्रहीत की जाएगी और बाद में पुनर्प्राप्त की जा सकती है।",
+      "fields": {
+        "instance": {
+          "name": "उदाहरण",
+          "description": "उपयोग करने के लिए HA टेक्स्ट AI उदाहरण का नाम"
+        },
+        "question": {
+          "name": "प्रश्न",
+          "description": "AI सहायक के लिए आपका प्रश्न या संकेत"
+        },
+        "context_messages": {
+          "name": "संदर्भ संदेश",
+          "description": "संदर्भ में शामिल करने के लिए पिछले संदेशों की संख्या (1-20)"
+        },
+        "system_prompt": {
+          "name": "सिस्टम प्रॉम्प्ट",
+          "description": "इस विशिष्ट प्रश्न के लिए संदर्भ सेट करने के लिए वैकल्पिक सिस्टम प्रॉम्प्ट"
+        },
+        "model": {
+          "name": "मॉडल",
+          "description": "उपयोग करने के लिए AI मॉडल का चयन करें (वैकल्पिक, डिफ़ॉल्ट सेटिंग को ओवरराइड करता है)"
+        },
+        "temperature": {
+          "name": "तापमान",
+          "description": "प्रतिक्रिया रचनात्मकता को नियंत्रित करता है (0.0-2.0)"
+        },
+        "max_tokens": {
+          "name": "अधिकतम टोकन",
+          "description": "प्रतिक्रिया की अधिकतम लंबाई (1-4096 टोकन)"
+        }
+      }
+    },
+    "clear_history": {
+      "name": "इतिहास साफ़ करें",
+      "description": "वार्तालाप इतिहास से सभी संग्रहीत प्रश्न और प्रतिक्रियाएँ हटाएँ",
+      "fields": {
+        "instance": {
+          "name": "उदाहरण",
+          "description": "इतिहास साफ़ करने के लिए HA टेक्स्ट AI उदाहरण का नाम"
+        }
+      }
+    },
+    "get_history": {
+      "name": "इतिहास प्राप्त करें",
+      "description": "वैकल्पिक फ़िल्टरिंग और सॉर्टिंग के साथ वार्तालाप इतिहास पुनर्प्राप्त करें",
+      "fields": {
+        "instance": {
+          "name": "उदाहरण",
+          "description": "इतिहास प्राप्त करने के लिए HA टेक्स्ट AI उदाहरण का नाम"
+        },
+        "limit": {
+          "name": "सीमा",
+          "description": "वापस करने के लिए वार्तालापों की संख्या (1-100)"
+        },
+        "filter_model": {
+          "name": "फ़िल्टर मॉडल",
+          "description": "विशिष्ट AI मॉडल द्वारा वार्तालापों को फ़िल्टर करें"
+        },
+        "start_date": {
+          "name": "प्रारंभ तिथि",
+          "description": "इस तिथि/समय से शुरू होने वाले वार्तालापों को फ़िल्टर करें"
+        },
+        "include_metadata": {
+          "name": "मेटाडेटा शामिल करें",
+          "description": "उपयोग किए गए टोकन, प्रतिक्रिया समय, आदि जैसी अतिरिक्त जानकारी शामिल करें।"
+        },
+        "sort_order": {
+          "name": "क्रमबद्ध करें",
+          "description": "परिणामों के लिए क्रमबद्ध क्रम (नवीनतम या सबसे पुराना पहले)"
+        }
+      }
+    },
+    "set_system_prompt": {
+      "name": "सिस्टम प्रॉम्प्ट सेट करें",
+      "description": "सभी भविष्य के वार्तालापों के लिए डिफ़ॉल्ट सिस्टम व्यवहार निर्देश सेट करें",
+      "fields": {
+        "instance": {
+          "name": "उदाहरण",
+          "description": "सिस्टम प्रॉम्प्ट सेट करने के लिए HA टेक्स्ट AI उदाहरण का नाम"
+        },
+        "prompt": {
+          "name": "सिस्टम प्रॉम्प्ट",
+          "description": "निर्देश जो परिभाषित करते हैं कि AI को कैसे व्यवहार करना चाहिए और जवाब देना चाहिए"
+        }
+      }
+    }
+  },
+  "entity": {
+    "sensor": {
+      "ha_text_ai": {
+        "name": "{name}",
+        "state": {
+          "ready": "तैयार",
+          "processing": "प्रक्रियाधीन",
+          "error": "त्रुटि",
+          "disconnected": "डिस्कनेक्टेड",
+          "rate_limited": "दर सीमित",
+          "maintenance": "रखरखाव",
+          "initializing": "आरंभिकरण",
+          "retrying": "पुनः प्रयास कर रहा है",
+          "queued": "कतारबद्ध"
+        },
+        "state_attributes": {
+          "question": {
+            "name": "अंतिम प्रश्न"
+          },
+          "response": {
+            "name": "अंतिम प्रतिक्रिया"
+          },
+          "model": {
+            "name": "वर्तमान मॉडल"
+          },
+          "temperature": {
+            "name": "तापमान"
+          },
+          "max_tokens": {
+            "name": "अधिकतम टोकन"
+          },
+          "system_prompt": {
+            "name": "सिस्टम प्रॉम्प्ट"
+          },
+          "response_time": {
+            "name": "अंतिम प्रतिक्रिया समय"
+          },
+          "total_responses": {
+            "name": "कुल प्रतिक्रियाएँ"
+          },
+          "error_count": {
+            "name": "त्रुटि गणना"
+          },
+          "last_error": {
+            "name": "अंतिम त्रुटि"
+          },
+          "api_status": {
+            "name": "API स्थिति"
+          },
+          "tokens_used": {
+            "name": "कुल टोकन उपयोग किए गए"
+          },
+          "average_response_time": {
+            "name": "औसत प्रतिक्रिया समय"
+          },
+          "last_request_time": {
+            "name": "अंतिम अनुरोध समय"
+          },
+          "is_processing": {
+            "name": "प्रसंस्करण स्थिति"
+          },
+          "is_rate_limited": {
+            "name": "दर सीमित स्थिति"
+          },
+          "is_maintenance": {
+            "name": "रखरखाव स्थिति"
+          },
+          "api_version": {
+            "name": "API संस्करण"
+          },
+          "endpoint_status": {
+            "name": "एंडपॉइंट स्थिति"
+          },
+          "performance_metrics": {
+            "name": "प्रदर्शन मेट्रिक्स"
+          },
+          "history_size": {
+            "name": "इतिहास का आकार"
+          },
+          "uptime": {
+            "name": "अपटाइम"
+          },
+          "total_tokens": {
+            "name": "कुल टोकन"
+          },
+          "prompt_tokens": {
+            "name": "प्रॉम्प्ट टोकन"
+          },
+          "completion_tokens": {
+            "name": "पूर्ण टोकन"
+          },
+          "successful_requests": {
+            "name": "सफल अनुरोध"
+          },
+          "failed_requests": {
+            "name": "असफल अनुरोध"
+          },
+          "average_latency": {
+            "name": "औसत विलंबता"
+          },
+          "max_latency": {
+            "name": "अधिकतम विलंबता"
+          },
+          "min_latency": {
+            "name": "न्यूनतम विलंबता"
+          }
+        }
+      }
+    }
+  }
+}

custom_components/ha_text_ai/translations/it.json

@@ -0,0 +1,266 @@
+{
+  "config": {
+    "step": {
+      "provider": {
+        "title": "Seleziona Provider AI",
+        "description": "Scegli quale provider di servizio AI utilizzare per questa istanza.",
+        "data": {
+          "api_provider": "Provider API",
+          "context_messages": "Numero di messaggi di contesto da conservare (1-20)"
+        }
+      },
+      "user": {
+        "title": "Configura Istanza HA Text AI",
+        "description": "Configura una nuova istanza di assistente AI con il provider selezionato.",
+        "data": {
+          "name": "Nome dell'istanza (es. 'Assistente GPT', 'Aiutante Claude')",
+          "api_key": "Chiave API per l'autenticazione",
+          "model": "Modello AI da utilizzare",
+          "temperature": "Creatività della risposta (0-2, più basso = più focalizzato)",
+          "max_tokens": "Lunghezza massima della risposta (1-4096 token)",
+          "api_endpoint": "URL endpoint API personalizzato (opzionale)",
+          "api_provider": "Provider API",
+          "request_interval": "Tempo minimo tra le richieste (0,1-60 secondi)",
+          "context_messages": "Numero di messaggi di contesto da conservare (1-20)",
+          "max_history_size": "Dimensione massima della cronologia delle conversazioni (1-100)"
+        }
+      }
+    },
+    "error": {
+      "name_exists": "Un'istanza con questo nome esiste già",
+      "invalid_name": "Nome dell'istanza non valido",
+      "invalid_auth": "Autenticazione fallita - controlla la tua chiave API",
+      "invalid_api_key": "Chiave API non valida - verifica le tue credenziali",
+      "cannot_connect": "Impossibile connettersi al servizio API",
+      "invalid_model": "Il modello selezionato non è disponibile",
+      "rate_limit": "Limite di velocità superato",
+      "context_length": "Lunghezza del contesto superata",
+      "rate_limit_exceeded": "Limite di velocità API superato",
+      "maintenance": "Il servizio è in manutenzione",
+      "invalid_response": "Risposta API non valida ricevuta",
+      "api_error": "Si è verificato un errore del servizio API",
+      "timeout": "Richiesta scaduta",
+      "invalid_instance": "Istanza non valida specificata",
+      "unknown": "Si è verificato un errore imprevisto",
+      "empty": "Il nome non può essere vuoto",
+      "invalid_characters": "Il nome può contenere solo lettere, numeri, spazi, trattini bassi e trattini",
+      "name_too_long": "Il nome non può superare i 50 caratteri"
+    }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "Aggiorna Impostazioni Istanza",
+        "description": "Modifica le impostazioni per questa istanza di assistente AI.",
+        "data": {
+          "model": "Modello AI",
+          "temperature": "Creatività della risposta (0-2)",
+          "max_tokens": "Lunghezza massima della risposta (1-4096)",
+          "request_interval": "Intervallo minimo tra le richieste (0,1-60 secondi)",
+          "context_messages": "Numero di messaggi precedenti da includere nel contesto (1-20)",
+          "max_history_size": "Dimensione massima della cronologia delle conversazioni (1-100)"
+        }
+      }
+    }
+  },
+  "services": {
+    "ask_question": {
+      "name": "Fai una Domanda (HA Text AI)",
+      "description": "Invia una domanda al modello AI e ricevi una risposta dettagliata. La risposta verrà memorizzata nella cronologia delle conversazioni e potrà essere recuperata in seguito.",
+      "fields": {
+        "instance": {
+          "name": "Istanza",
+          "description": "Nome dell'istanza HA Text AI da utilizzare"
+        },
+        "question": {
+          "name": "Domanda",
+          "description": "La tua domanda o prompt per l'assistente AI"
+        },
+        "context_messages": {
+          "name": "Messaggi di Contesto",
+          "description": "Numero di messaggi precedenti da includere nel contesto (1-20)"
+        },
+        "system_prompt": {
+          "name": "Prompt di Sistema",
+          "description": "Prompt di sistema opzionale per impostare il contesto per questa specifica domanda"
+        },
+        "model": {
+          "name": "Modello",
+          "description": "Seleziona il modello AI da utilizzare (opzionale, sovrascrive l'impostazione predefinita)"
+        },
+        "temperature": {
+          "name": "Temperatura",
+          "description": "Controlla la creatività della risposta (0.0-2.0)"
+        },
+        "max_tokens": {
+          "name": "Max Token",
+          "description": "Lunghezza massima della risposta (1-4096 token)"
+        }
+      }
+    },
+    "clear_history": {
+      "name": "Cancella Cronologia",
+      "description": "Elimina tutte le domande e le risposte memorizzate dalla cronologia delle conversazioni",
+      "fields": {
+        "instance": {
+          "name": "Istanza",
+          "description": "Nome dell'istanza HA Text AI per cui cancellare la cronologia"
+        }
+      }
+    },
+    "get_history": {
+      "name": "Ottieni Cronologia",
+      "description": "Recupera la cronologia delle conversazioni con filtro e ordinamento opzionali",
+      "fields": {
+        "instance": {
+          "name": "Istanza",
+          "description": "Nome dell'istanza HA Text AI da cui ottenere la cronologia"
+        },
+        "limit": {
+          "name": "Limite",
+          "description": "Numero di conversazioni da restituire (1-100)"
+        },
+        "filter_model": {
+          "name": "Filtro Modello",
+          "description": "Filtra le conversazioni per specifico modello AI"
+        },
+        "start_date": {
+          "name": "Data di Inizio",
+          "description": "Filtra le conversazioni a partire da questa data/ora"
+        },
+        "include_metadata": {
+          "name": "Includi Metadati",
+          "description": "Includi informazioni aggiuntive come token utilizzati, tempo di risposta, ecc."
+        },
+        "sort_order": {
+          "name": "Ordine di Ordinamento",
+          "description": "Ordine di ordinamento per i risultati (più recente o più vecchio per primo)"
+        }
+      }
+    },
+    "set_system_prompt": {
+      "name": "Imposta Prompt di Sistema",
+      "description": "Imposta le istruzioni di comportamento predefinite del sistema per tutte le future conversazioni",
+      "fields": {
+        "instance": {
+          "name": "Istanza",
+          "description": "Nome dell'istanza HA Text AI per cui impostare il prompt di sistema"
+        },
+        "prompt": {
+          "name": "Prompt di Sistema",
+          "description": "Istruzioni che definiscono come l'IA dovrebbe comportarsi e rispondere"
+        }
+      }
+    }
+  },
+  "entity": {
+    "sensor": {
+      "ha_text_ai": {
+        "name": "{name}",
+        "state": {
+          "ready": "Pronto",
+          "processing": "In elaborazione",
+          "error": "Errore",
+          "disconnected": "Disconnesso",
+          "rate_limited": "Limite di Velocità Raggiunto",
+          "maintenance": "Manutenzione",
+          "initializing": "Inizializzazione",
+          "retrying": "Riprovando",
+          "queued": "In coda"
+        },
+        "state_attributes": {
+          "question": {
+            "name": "Ultima Domanda"
+          },
+          "response": {
+            "name": "Ultima Risposta"
+          },
+          "model": {
+            "name": "Modello Attuale"
+          },
+          "temperature": {
+            "name": "Temperatura"
+          },
+          "max_tokens": {
+            "name": "Max Token"
+          },
+          "system_prompt": {
+            "name": "Prompt di Sistema"
+          },
+          "response_time": {
+            "name": "Tempo di Risposta Ultima"
+          },
+          "total_responses": {
+            "name": "Totale Risposte"
+          },
+          "error_count": {
+            "name": "Numero di Errori"
+          },
+          "last_error": {
+            "name": "Ultimo Errore"
+          },
+          "api_status": {
+            "name": "Stato API"
+          },
+          "tokens_used": {
+            "name": "Totale Token Utilizzati"
+          },
+          "average_response_time": {
+            "name": "Tempo di Risposta Medio"
+          },
+          "last_request_time": {
+            "name": "Tempo Ultima Richiesta"
+          },
+          "is_processing": {
+            "name": "Stato Elaborazione"
+          },
+          "is_rate_limited": {
+            "name": "Stato Limite Velocità"
+          },
+          "is_maintenance": {
+            "name": "Stato Manutenzione"
+          },
+          "api_version": {
+            "name": "Versione API"
+          },
+          "endpoint_status": {
+            "name": "Stato Endpoint"
+          },
+          "performance_metrics": {
+            "name": "Metriche Prestazioni"
+          },
+          "history_size": {
+            "name": "Dimensione Cronologia"
+          },
+          "uptime": {
+            "name": "Tempo di Funzionamento"
+          },
+          "total_tokens": {
+            "name": "Totale Token"
+          },
+          "prompt_tokens": {
+            "name": "Token Prompt"
+          },
+          "completion_tokens": {
+            "name": "Token Completamento"
+          },
+          "successful_requests": {
+            "name": "Richieste Riuscite"
+          },
+          "failed_requests": {
+            "name": "Richieste Fallite"
+          },
+          "average_latency": {
+            "name": "Latency Media"
+          },
+          "max_latency": {
+            "name": "Latency Massima"
+          },
+          "min_latency": {
+            "name": "Latency Minima"
+            }
+          }
+        }
+      }
+    }
+  }

custom_components/ha_text_ai/translations/sr.json

@@ -0,0 +1,266 @@
+{
+  "config": {
+    "step": {
+      "provider": {
+        "title": "Изаберите добављача вештачке интелигенције",
+        "description": "Изаберите добављача услуга вештачке интелигенције који ћете користити за ову инстанцу.",
+        "data": {
+          "api_provider": "Добављач API-ја",
+          "context_messages": "Број порука контекста које треба задржати (1-20)"
+        }
+      },
+      "user": {
+        "title": "Конфигуришите инстанцу HA Text AI",
+        "description": "Поставите нову инстанцу асистента вештачке интелигенције са изабраним добављачем.",
+        "data": {
+          "name": "Назив инстанце (нпр. 'GPT Assistant', 'Claude Helper')",
+          "api_key": "API кључ за аутентификацију",
+          "model": "Модел вештачке интелигенције који треба користити",
+          "temperature": "Креативност одговора (0-2, нижа = више фокусирана)",
+          "max_tokens": "Максимална дужина одговора (1-4096 токена)",
+          "api_endpoint": "Прилагођени URL завршног тачка API-ја (опционо)",
+          "api_provider": "Добављач API-ја",
+          "request_interval": "Минимално време између захтева (0.1-60 секунди)",
+          "context_messages": "Број порука контекста које треба задржати (1-20)",
+          "max_history_size": "Максимална величина историје разговора (1-100)"
+        }
+      }
+    },
+    "error": {
+      "name_exists": "Инстанца са овим називом већ постоји",
+      "invalid_name": "Неважећи назив инстанце",
+      "invalid_auth": "Аутентификација није успела - проверите свој API кључ",
+      "invalid_api_key": "Неважећи API кључ - проверите своје податке о верификацији",
+      "cannot_connect": "Није могуће успоставити везу са услугом API-ја",
+      "invalid_model": "Изабрани модел није доступан",
+      "rate_limit": "Прекорачен је лимит стопе",
+      "context_length": "Прекорачена је дужина контекста",
+      "rate_limit_exceeded": "Прекорачен је лимит стопе API-ја",
+      "maintenance": "Услуга је у фази одржавања",
+      "invalid_response": "Примљен је неважећи одговор API-ја",
+      "api_error": "Догодила се грешка у услузи API-ја",
+      "timeout": "Захтев је истекао",
+      "invalid_instance": "Наведена је неважећа инстанца",
+      "unknown": "Догодила се неочекивана грешка",
+      "empty": "Назив не може бити празан",
+      "invalid_characters": "Назив може да садржи само слова, бројеве, размаке, цртице и цртице",
+      "name_too_long": "Назив мора бити 50 карактера или мање"
+    }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "Ажурирајте подешавања инстанце",
+        "description": "Измените подешавања за ову инстанцу асистента вештачке интелигенције.",
+        "data": {
+          "model": "Модел вештачке интелигенције",
+          "temperature": "Креативност одговора (0-2)",
+          "max_tokens": "Максимална дужина одговора (1-4096)",
+          "request_interval": "Минимални интервал захтева (0.1-60 секунди)",
+          "context_messages": "Број претходних порука које треба укључити у контекст (1-20)",
+          "max_history_size": "Максимална величина историје разговора (1-100)"
+        }
+      }
+    }
+  },
+  "services": {
+    "ask_question": {
+      "name": "Поставите питање (HA Text AI)",
+      "description": "Пошаљите питање моделу вештачке интелигенције и добијте детаљан одговор. Одговор ће бити сачуван у историји разговора и може се касније преузети.",
+      "fields": {
+        "instance": {
+          "name": "Инстанца",
+          "description": "Назив инстанце HA Text AI коју треба користити"
+        },
+        "question": {
+          "name": "Питање",
+          "description": "Ваше питање или наговештај за асистента вештачке интелигенције"
+        },
+        "context_messages": {
+          "name": "Поруке контекста",
+          "description": "Број претходних порука које треба укључити у контекст (1-20)"
+        },
+        "system_prompt": {
+          "name": "Системски наговештај",
+          "description": "Опциони системски наговештај за постављање контекста за ово одређено питање"
+        },
+        "model": {
+          "name": "Модел",
+          "description": "Изаберите модел вештачке интелигенције који треба користити (опционо, преклапа подразумевано подешавање)"
+        },
+        "temperature": {
+          "name": "Температура",
+          "description": "Контролише креативност одговора (0.0-2.0)"
+        },
+        "max_tokens": {
+          "name": "Макс. токени",
+          "description": "Максимална дужина одговора (1-4096 токена)"
+        }
+      }
+    },
+    "clear_history": {
+      "name": "Обриши историју",
+      "description": "Обришите сва сачувана питања и одговоре из историје разговора",
+      "fields": {
+        "instance": {
+          "name": "Инстанца",
+          "description": "Назив инстанце HA Text AI за коју треба очистити историју"
+        }
+      }
+    },
+    "get_history": {
+      "name": "Добиј историју",
+      "description": "Преузмите историју разговора са опционом филтрацијом и сортирањем",
+      "fields": {
+        "instance": {
+          "name": "Инстанца",
+          "description": "Назив инстанце HA Text AI из које треба добити историју"
+        },
+        "limit": {
+          "name": "Лимит",
+          "description": "Број разговора који треба вратити (1-100)"
+        },
+        "filter_model": {
+          "name": "Филтер модела",
+          "description": "Филтрирајте разговоре по одређеном моделу вештачке интелигенције"
+        },
+        "start_date": {
+          "name": "Почетни датум",
+          "description": "Филтрирајте разговоре почев од овог датума/времена"
+        },
+        "include_metadata": {
+          "name": "Укључи метаподатке",
+          "description": "Укључите додатне информације попут коришћених токена, времена одговора и слично."
+        },
+        "sort_order": {
+          "name": "Редослед сортирања",
+          "description": "Редослед сортирања за резултате (најновији или најстарији прво)"
+        }
+      }
+    },
+    "set_system_prompt": {
+      "name": "Поставите системски наговештај",
+      "description": "Поставите подразумевана упутства за понашање система за све будуће разговоре",
+      "fields": {
+        "instance": {
+          "name": "Инстанца",
+          "description": "Назив инстанце HA Text AI за коју треба поставити системски наговештај"
+        },
+        "prompt": {
+          "name": "Системски наговештај",
+          "description": "Упутства која дефинишу како би се вештачка интелигенција требала понашати и одговарати"
+        }
+      }
+    }
+  },
+  "entity": {
+    "sensor": {
+      "ha_text_ai": {
+        "name": "{name}",
+        "state": {
+          "ready": "Спремно",
+          "processing": "Обрада",
+          "error": "Грешка",
+          "disconnected": "Искључено",
+          "rate_limited": "Лимит стопе",
+          "maintenance": "Одржавање",
+          "initializing": "Иницијализација",
+          "retrying": "Понављање",
+          "queued": "У реду чекања"
+        },
+        "state_attributes": {
+          "question": {
+            "name": "Последње питање"
+          },
+          "response": {
+            "name": "Последњи одговор"
+          },
+          "model": {
+            "name": "Тренутни модел"
+          },
+          "temperature": {
+            "name": "Температура"
+          },
+          "max_tokens": {
+            "name": "Макс. токени"
+          },
+          "system_prompt": {
+            "name": "Системски наговештај"
+          },
+          "response_time": {
+            "name": "Време последњег одговора"
+          },
+          "total_responses": {
+            "name": "Укупан број одговора"
+          },
+          "error_count": {
+            "name": "Број грешака"
+          },
+          "last_error": {
+            "name": "Последња грешка"
+          },
+          "api_status": {
+            "name": "Статус API-ја"
+          },
+          "tokens_used": {
+            "name": "Укупно коришћених токена"
+          },
+          "average_response_time": {
+            "name": "Просечно време одговора"
+          },
+          "last_request_time": {
+            "name": "Време последњег захтева"
+          },
+          "is_processing": {
+            "name": "Статус обраде"
+          },
+          "is_rate_limited": {
+            "name": "Статус ограничења стопе"
+          },
+          "is_maintenance": {
+            "name": "Статус одржавања"
+          },
+          "api_version": {
+            "name": "Верзија API-ја"
+          },
+          "endpoint_status": {
+            "name": "Статус завршне тачке"
+          },
+          "performance_metrics": {
+            "name": "Метрике перформанси"
+          },
+          "history_size": {
+            "name": "Величина историје"
+          },
+          "uptime": {
+            "name": "Време рада"
+          },
+          "total_tokens": {
+            "name": "Укупан број токена"
+          },
+          "prompt_tokens": {
+            "name": "Токени наговештаја"
+          },
+          "completion_tokens": {
+            "name": "Токени довршетака"
+          },
+          "successful_requests": {
+            "name": "Успешни захтеви"
+          },
+          "failed_requests": {
+            "name": "Неуспешни захтеви"
+          },
+          "average_latency": {
+            "name": "Просечна латенција"
+          },
+          "max_latency": {
+            "name": "Максимална латенција"
+          },
+          "min_latency": {
+            "name": "Минимална латенција"
+          }
+        }
+      }
+    }
+  }
+}

custom_components/ha_text_ai/translations/zh.json

@@ -0,0 +1,266 @@
+{
+  "config": {
+    "step": {
+      "provider": {
+        "title": "选择 AI 提供商",
+        "description": "选择要用于此实例的 AI 服务提供商。",
+        "data": {
+          "api_provider": "API 提供商",
+          "context_messages": "要保留的上下文消息数量 (1-20)"
+        }
+      },
+      "user": {
+        "title": "配置 HA Text AI 实例",
+        "description": "使用您选择的提供商设置新的 AI 助手实例。",
+        "data": {
+          "name": "实例名称（例如，“GPT 助手”、“Claude 助手”）",
+          "api_key": "用于身份验证的 API 密钥",
+          "model": "要使用的 AI 模型",
+          "temperature": "回复创意度 (0-2，数值越低，回复越聚焦)",
+          "max_tokens": "最大回复长度（1-4096 个 Token）",
+          "api_endpoint": "自定义 API 端点 URL（可选）",
+          "api_provider": "API 提供商",
+          "request_interval": "请求之间的最短时间间隔（0.1-60 秒）",
+          "context_messages": "要保留的上下文消息数量 (1-20)",
+          "max_history_size": "最大对话历史记录大小 (1-100)"
+        }
+      }
+    },
+    "error": {
+      "name_exists": "已存在具有此名称的实例",
+      "invalid_name": "无效的实例名称",
+      "invalid_auth": "身份验证失败 - 请检查您的 API 密钥",
+      "invalid_api_key": "无效的 API 密钥 - 请验证您的凭据",
+      "cannot_connect": "无法连接到 API 服务",
+      "invalid_model": "所选模型不可用",
+      "rate_limit": "超出速率限制",
+      "context_length": "上下文长度超出限制",
+      "rate_limit_exceeded": "API 速率限制已超出",
+      "maintenance": "服务正在维护中",
+      "invalid_response": "收到无效的 API 响应",
+      "api_error": "发生 API 服务错误",
+      "timeout": "请求超时",
+      "invalid_instance": "指定的实例无效",
+      "unknown": "发生意外错误",
+      "empty": "名称不能为空",
+      "invalid_characters": "名称只能包含字母、数字、空格、下划线和连字符",
+      "name_too_long": "名称必须为 50 个字符或更少"
+    }
+  },
+  "options": {
+    "step": {
+      "init": {
+        "title": "更新实例设置",
+        "description": "修改此 AI 助手实例的设置。",
+        "data": {
+          "model": "AI 模型",
+          "temperature": "回复创意度 (0-2)",
+          "max_tokens": "最大回复长度 (1-4096)",
+          "request_interval": "最短请求间隔 (0.1-60 秒)",
+          "context_messages": "包含在上下文中的先前消息数 (1-20)",
+          "max_history_size": "最大对话历史记录大小 (1-100)"
+        }
+      }
+    }
+  },
+  "services": {
+    "ask_question": {
+      "name": "提问 (HA Text AI)",
+      "description": "向 AI 模型发送问题并接收详细的回复。回复将存储在对话历史记录中，以后可以检索。",
+      "fields": {
+        "instance": {
+          "name": "实例",
+          "description": "要使用的 HA Text AI 实例的名称"
+        },
+        "question": {
+          "name": "问题",
+          "description": "您要向 AI 助手提出的问题或提示"
+        },
+        "context_messages": {
+          "name": "上下文消息",
+          "description": "包含在上下文中的先前消息数 (1-20)"
+        },
+        "system_prompt": {
+          "name": "系统提示",
+          "description": "可选系统提示，用于为特定问题设置上下文"
+        },
+        "model": {
+          "name": "模型",
+          "description": "选择要使用的 AI 模型（可选，覆盖默认设置）"
+        },
+        "temperature": {
+          "name": "温度",
+          "description": "控制回复创意度 (0.0-2.0)"
+        },
+        "max_tokens": {
+          "name": "最大 Token 数",
+          "description": "回复的最大长度（1-4096 个 Token）"
+        }
+      }
+    },
+    "clear_history": {
+      "name": "清除历史记录",
+      "description": "删除对话历史记录中所有存储的问题和回复",
+      "fields": {
+        "instance": {
+          "name": "实例",
+          "description": "要清除历史记录的 HA Text AI 实例的名称"
+        }
+      }
+    },
+    "get_history": {
+      "name": "获取历史记录",
+      "description": "检索对话历史记录，并可选择进行过滤和排序",
+      "fields": {
+        "instance": {
+          "name": "实例",
+          "description": "要从中获取历史记录的 HA Text AI 实例的名称"
+        },
+        "limit": {
+          "name": "限制",
+          "description": "要返回的对话数量 (1-100)"
+        },
+        "filter_model": {
+          "name": "筛选模型",
+          "description": "按特定 AI 模型筛选对话"
+        },
+        "start_date": {
+          "name": "开始日期",
+          "description": "从该日期/时间开始筛选对话"
+        },
+        "include_metadata": {
+          "name": "包含元数据",
+          "description": "包含其他信息，例如使用的 Token 数、响应时间等。"
+        },
+        "sort_order": {
+          "name": "排序顺序",
+          "description": "结果的排序顺序（最新的或最早的优先）"
+        }
+      }
+    },
+    "set_system_prompt": {
+      "name": "设置系统提示",
+      "description": "为所有将来的对话设置默认系统行为说明",
+      "fields": {
+        "instance": {
+          "name": "实例",
+          "description": "要为其设置系统提示的 HA Text AI 实例的名称"
+        },
+        "prompt": {
+          "name": "系统提示",
+          "description": "定义 AI 如何行为和响应的说明"
+        }
+      }
+    }
+  },
+  "entity": {
+    "sensor": {
+      "ha_text_ai": {
+        "name": "{name}",
+        "state": {
+          "ready": "就绪",
+          "processing": "处理中",
+          "error": "错误",
+          "disconnected": "已断开连接",
+          "rate_limited": "速率限制",
+          "maintenance": "维护",
+          "initializing": "初始化中",
+          "retrying": "重试中",
+          "queued": "排队中"
+        },
+        "state_attributes": {
+          "question": {
+            "name": "最后一个问题"
+          },
+          "response": {
+            "name": "最后一个回复"
+          },
+          "model": {
+            "name": "当前模型"
+          },
+          "temperature": {
+            "name": "温度"
+          },
+          "max_tokens": {
+            "name": "最大 Token 数"
+          },
+          "system_prompt": {
+            "name": "系统提示"
+          },
+          "response_time": {
+            "name": "上次回复时间"
+          },
+          "total_responses": {
+            "name": "总回复次数"
+          },
+          "error_count": {
+            "name": "错误计数"
+          },
+          "last_error": {
+            "name": "上次错误"
+          },
+          "api_status": {
+            "name": "API 状态"
+          },
+          "tokens_used": {
+            "name": "已使用的 Token 总数"
+          },
+          "average_response_time": {
+            "name": "平均回复时间"
+          },
+          "last_request_time": {
+            "name": "上次请求时间"
+          },
+          "is_processing": {
+            "name": "处理状态"
+          },
+          "is_rate_limited": {
+            "name": "速率限制状态"
+          },
+          "is_maintenance": {
+            "name": "维护状态"
+          },
+          "api_version": {
+            "name": "API 版本"
+          },
+          "endpoint_status": {
+            "name": "端点状态"
+          },
+          "performance_metrics": {
+            "name": "性能指标"
+          },
+          "history_size": {
+            "name": "历史记录大小"
+          },
+          "uptime": {
+            "name": "正常运行时间"
+          },
+          "total_tokens": {
+            "name": "总 Token 数"
+          },
+          "prompt_tokens": {
+            "name": "提示 Token 数"
+          },
+          "completion_tokens": {
+            "name": "完成 Token 数"
+          },
+          "successful_requests": {
+            "name": "成功请求数"
+          },
+          "failed_requests": {
+            "name": "失败请求数"
+          },
+          "average_latency": {
+            "name": "平均延迟"
+          },
+          "max_latency": {
+            "name": "最大延迟"
+          },
+          "min_latency": {
+            "name": "最小延迟"
+          }
+        }
+      }
+    }
+  }
+}