KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

home_assistant_mistral_ai

★ 28 Open GitHub ↗

Mistral AI Integration in Home Assistant

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![alt text](https://raw.githubusercontent.com/home-assistant/brands/refs/heads/master/custom_integrations/mistral_ai_api/logo%402x.png)

<details>
 <summary>Table of Contents</summary>
 <ol>
 <li>
 <a href="#about-the-project">About The Project</a>	
 </li>
 <li>
 <a href="#what-is-mistral-ai">What is Mistral AI</a>	
 </li>
 <li>
	<a href="#example-use-cases">Example Use-Cases</a>
 </li>
 <li>
 <a href="#getting-started">Getting Started</a>
 <ul>
 <li><a href="#prerequisites">Prerequisites</a></li>
 <li><a href="#installation">Installation</a></li>
 </ul>
 </li>
 <li>
	<a href="#usage">Usage</a>
 	<ul>
	 <li><a href="#service">Service</a></li>
	 <li><a href="#event">Event</a></li>
	 <li><a href="#sensor-entity">Sensor Entity</a></li>
	</ul>
 </li>
 </ol>
</details>

## About The Project

This is a custom integration for [Home Assistant](https://www.home-assistant.io/) which allows for sending prompts to [Mistral AI](https://mistral.ai/)
(<a href="#readme-top">back to top</a>)

## What is Mistral AI
Mistral AI is a generative AI created in europe (france). It offers different models of their ai, each specialized for different topics.
This ai had high scores in several benchmarks, even beating previous versions of Chat GPT.
Right now using Mistral AI is free.

(<a href="#readme-top">back to top</a>)

## Example Use-Cases

<lu>
 <li>Let mistral ai decide wether you should open the windows. Send the outside temperature and humidity to mistral ai along with the avarage temperature and humidity of all your rooms.</li>
 <li>Get dynamic push notifications created by the AI instead of the same static sentences you normall define.</li>
 <li>Feed mistral ai with your workout data to get a quick summary</li>
 <li>Use mistral ai coding model to let it generate jinja + markdown to populate your dashboard</li>
 <li>Generate template sensor code using mistral coding model</li>
</lu>

## Getting Started

Before you can use the integration check the prerequisites. Once thats done, follow up with the installation

### Prerequisites

In order to be able to use this integration you must sign-up with [Mistral AI](https://mistral.ai/). This is currently free!
Once you got your account you can request an API-Key. 
If you wish to use agents you can also define those in the developer portal. Each agent has its unique id which you can use in this integration.

(<a href="#readme-top">back to top</a>)

## Installation

Download the files from this repository and place the mistral_ai_api directory into your custom_components directory.
Next, add the following entry to your configuration.yaml

```yaml
  mistral_ai_api:
    name: "Mistral AI API"
    api_key: !secret mistral_token
  ```

Once that's done add an entry for mistral_token to your secrets.yaml
The token is the token your received from registering with mistral ai.

Now, restart Home Assistant and you should be good to go.

## Usage

The integration offers three key-parts

<lu>
	<li>A service called mistral_ai_api.send_prompt</li>
	<li>An event with the identifier mistral_ai_response</li>
	<li>The sensor.mistral_ai_api-Entity</li>
</lu>

### Service

You can call the send_prompt-command like this

```yaml
    action: mistral_ai_api.send_prompt
    metadata: {}
    data:
      prompt: Whats the weather
      identifier: my-question-123
```

Or like this

```yaml
    action: mistral_ai_api.send_prompt
      metadata: {}
        data:
          prompt: Give me a jinja2 template to show some data in a nice formatted way. Make sure to only return the code as-is so I can use it directly in a markdown. Don't add any explanation, just return the code.
          model: codestral-latest
          identifier: my-question-123
          conversation_id: my-conversation
```

This will send the prompt to mistral ai.
Once mistral ai sent back the response the mentioned event will be thrown and the sensor-Entity will get its state and attribute updated.

As you can see the mistral_ai_api.send_prompt takes additional (optional) arguments

<table>
	<tr>
		<td>prompt</t>
		<td>The prompt to send to mistral</td>
	<tr>
	<tr>
		<td>conversation_id</t>
		<td>optional	If you want to have a real conversation with the model (not just one answer to one prompt and then be done) you need to supply
		a conversation id. This is used as a filename so, please be careful with deciding for a name.</td>
	<tr>
	<tr>
		<td>model</t>
		<td>The mistral ai model to be used. Not required when using an agent</td>
	<tr>
	<tr>
		<td>agent_id</t>
		<td>optional	The id of an agent you want to utilize</td>
	<tr>
	<tr>
		<td>identifier</t>
		<td>optional	A custom identifier which will be returned in the event so you know which prompt the answer belonged to</td>
	<tr>
	<tr>
		<td>timeout</t>
		<td>optional	Timeout in seconds which defines how long home assistant should wait for an answer before terminating the request. Value of 60 seconds seems fine.</td>
	<tr>
</table>

In addition to this there is another service called "mistral_ai_api.retrieve_last"
This service will return the data for the last communication with mistral ai.
The data consists of the following

<table>
	<tr>
		<td>last_prompt</t>
		<td>The prompt that was last sent</td>
	<tr>
	<tr>
		<td>last_response</t>
		<td>The last response returned by mistral</td>
	<tr>
	<tr>
		<td>identifier</t>
		<td>The last identifier assigned to the communication</td>
	<tr>
	<tr>
		<td>timestamp</td>
		<td>The last set timestamp</td>
	<tr>
</table>

This example code shows how to use the service action in a script in home assistant

```yaml
    alias: "[Mistral AI] Retrieve last communication"
    sequence:
        - action: mistral_ai_api.retrieve_last
          metadata: {}
          data: {}
          response_variable: result
        - variables:
              identifier: "{{result.identifier}}"
              last_prompt: "{{result.last_prompt}}"
              last_response: "{{result.last_response}}"
              timestamp: "{{result.timestamp}}"
description: "Retrieves the last communication with mistral"
```

### Event
You can react to that in an automation and do whatever you want with the result

```yaml
    alias: "[Mistral AI] React on mistral ai response"
    description: ""
    triggers:
      - trigger: event
        event_type: mistral_ai_response
    conditions: []
    actions:
      - action: notify.mobile_app_iphone_5
        metadata: {}
        data:
          message: >-
            {{trigger.event.data.identifier}} - {{trigger.event.data.agent_id}} -
            {{trigger.event.data.response}}
    mode: single
```

### Sensor Entity

In addition to the event the integration also ships with a Sensor.
The id of the sensor is sensor.mistral_ai_api.
This sensor can have one of two states

<table>
	<tr><td>idle</td><td>Not doing anything. This is the state it starts with</td></tr>
	<tr><td>processingb></td><td>A prompt was sent to mistral ai. Now waiting for the response</td></tr>	
</table>

Given these two states one could create an automation that reacts to the change of the state from idle to processing.

Next up there are a couple of attributes for this entity which are as follows

<table>
	<tr><td>last_prompt</td><td>The last response that was sent to mistral ai</td></tr>
	<tr><td>last_response</td><td>The last response from mistral ai</td></tr>
	<tr><td>identifier</td><td>The last identifier belonging to the prompt and response</td></tr>
	<tr><td>timestamp</td><td>A timestamp that is refreshed whenever a prompt was sent or a response was received</td></tr>
</table>

(<a href="#readme-top">back to top</a>)

home_assistant_mistral_ai

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README