# Google Assistant Library > [!WARNING] > **Warning:** The Google Assistant Library for Python is deprecated as of June 28th, 2019. Use the [Google Assistant Service](https://developers.google.com/assistant/sdk/guides/service/python) instead. google.assistant.library package. *class* `google.assistant.library.``Assistant`(*credentials* , *device_model_id* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant "Permalink to this definition") : Client for the Google Assistant Library. Provides basic control functionality and lifecycle handling for the Google Assistant. It is best practice to use the Assistant as a `ContextManager`: ``` with Assistant(credentials, device_model_id) as assistant: ``` This allows the underlying native implementation to properly handle memory management. Once [`start()`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start "google.assistant.library.Assistant.start") is called, the Assistant generates a stream of Events relaying the various states the Assistant is currently in, for example: ``` ON_CONVERSATION_TURN_STARTED ON_END_OF_UTTERANCE ON_RECOGNIZING_SPEECH_FINISHED: {'text': 'what time is it'} ON_RESPONDING_STARTED: {'is_error_response': False} ON_RESPONDING_FINISHED ON_CONVERSATION_TURN_FINISHED: {'with_follow_on_turn': False} ``` See [`EventType`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType "google.assistant.library.event.EventType") for details on all events and their arguments. Glossary: - *Hotword*: The phrase the Assistant listens for when not muted: ``` "OK Google" OR "Hey Google" ``` - *Turn*: A single user request followed by a response from the Assistant. - *Conversation*: One or more turns which result in a desired final result from the Assistant: ``` "What time is it?" -> "The time is 6:24 PM" OR "Set a timer" -> "Okay, for how long?" -> "5 minutes" -> "Sure, 5 minutes, starting now!" ``` | Parameters: | - **credentials** (*google.oauth2.credentials.Credentials*) -- The user's Google OAuth2 credentials. - **device_model_id** (*str*) -- The device_model_id that was registered for your project with Google. This must not be an empty string. | | Raises: | `ValueError` -- If `device_model_id` was left as None or empty. | |---|---| `device_id`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.device_id "Permalink to this definition") : Returns the device ID generated by the Assistant. This value identifies your device to the server when using services such as Google Device Actions. This property is only filled AFTER [`start()`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start "google.assistant.library.Assistant.start") has been called. | Returns: | The device id once [`start()`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start "google.assistant.library.Assistant.start") has been called, empty string otherwise. | | Return type: | str | |---|---| `send_text_query`(*query* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.send_text_query "Permalink to this definition") : Sends [\|query\|](https://developers.google.com/assistant/sdk/reference/library/python#id1) to the Assistant as if it were spoken by the user. This will behave the same as a user speaking the hotword and making a query OR speaking the answer to a follow-on query. | Parameters: | **query** (*str*) -- The text query to send to the Assistant. | |---|---| `set_mic_mute`(*is_muted* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.set_mic_mute "Permalink to this definition") : Stops the Assistant from listening for the hotword. Allows for disabling the Assistant from listening for the hotword. This provides functionality similar to the privacy button on the back of Google Home. This method is a no-op if the Assistant has not yet been started. | Parameters: | **is_muted** (*bool*) -- True stops the Assistant from listening and False allows it to start again. | |---|---| `start`()[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start "Permalink to this definition") : Starts the Assistant, which includes listening for a hotword. Once [`start()`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start "google.assistant.library.Assistant.start") is called, the Assistant will begin processing data from the 'default' ALSA audio source, listening for the hotword. This will also start other services provided by the Assistant, such as timers/alarms. This method can only be called once. Once called, the Assistant will continue to run until `__exit__` is called. | Returns: | A queue of events that notify of changes to the Assistant state. | | Return type: | google.assistant.event.IterableEventQueue | |---|---| `start_conversation`()[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start_conversation "Permalink to this definition") : Manually starts a new conversation with the Assistant. Starts both recording the user's speech and sending it to Google, similar to what happens when the Assistant hears the hotword. This method is a no-op if the Assistant is not started or has been muted. `stop_conversation`()[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.stop_conversation "Permalink to this definition") : Stops any active conversation with the Assistant. The Assistant could be listening to the user's query OR responding. If there is no active conversation, this is a no-op. *class* `google.assistant.library.event.``AlertEvent`(*event_type* , *args* , *\*\*_* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.AlertEvent "Permalink to this definition") : Extends Event to add parsing of 'alert_type'. *class* `google.assistant.library.event.``AlertType`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.AlertType "Permalink to this definition") : Alert types. Used with [`ON_ALERT_STARTED`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_ALERT_STARTED "google.assistant.library.event.EventType.ON_ALERT_STARTED") and [`ON_ALERT_FINISHED`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_ALERT_FINISHED "google.assistant.library.event.EventType.ON_ALERT_FINISHED") events. `ALARM`*= 0* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.AlertType.ALARM "Permalink to this definition") : An event set for an absolute time such as '3 A.M on Monday' `TIMER`*= 1* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.AlertType.TIMER "Permalink to this definition") : An event set for a relative time such as '30 seconds from now' *class* `google.assistant.library.event.``DeviceActionEvent`(*event_type* , *args* , *\*\*kwargs* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.DeviceActionEvent "Permalink to this definition") : Extends Event to add 'actions' property. `actions`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.DeviceActionEvent.actions "Permalink to this definition") : A generator of commands to execute for the current device. *class* `google.assistant.library.event.``Event`(*event_type* , *args* , *\*\*_* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.Event "Permalink to this definition") : An event generated by the Assistant. `type`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.Event.type "Permalink to this definition") : *EventType* -- The type of event that was generated. `args`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.Event.args "Permalink to this definition") : *dict* -- Argument key/value pairs associated with this event. *static* `New`(*event_type* , *args* , *\*\*kwargs* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.Event.New "Permalink to this definition") : Create new event using a specialized Event class when needed. | Parameters: | - **event_type** (*int*) -- A numeric id corresponding to an event in google.assistant.event.EventType. - **args** (*dict*) -- Argument key/value pairs associated with this event. - **kwargs** (*dict*) -- Optional argument key/value pairs specific to a specialization of the Event class for an EventType. | |---|---| *class* `google.assistant.library.event.``EventType`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType "Permalink to this definition") : Event types. `ON_ALERT_FINISHED`*= 11* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_ALERT_FINISHED "Permalink to this definition") : Indicates the alert of `alert_type` has finished sounding. | Parameters: | **alert_type** ([*AlertType*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.AlertType "google.assistant.library.event.AlertType")) -- The id of the Enum representing the type of alert which just finished. | |---|---| `ON_ALERT_STARTED`*= 10* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_ALERT_STARTED "Permalink to this definition") : Indicates that an alert has started sounding. This alert will continue until [`ON_ALERT_FINISHED`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_ALERT_FINISHED "google.assistant.library.event.EventType.ON_ALERT_FINISHED") with the same `alert_type` is received. Only one alert should be active at any given time. | Parameters: | **alert_type** ([*AlertType*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.AlertType "google.assistant.library.event.AlertType")) -- The id of the Enum representing the currently sounding type of alert. | |---|---| `ON_ASSISTANT_ERROR`*= 12* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_ASSISTANT_ERROR "Permalink to this definition") : Indicates if the Assistant library has encountered an error. | Parameters: | **is_fatal** (*bool*) -- If True then the Assistant will be unable to recover and should be restarted. | |---|---| `ON_CONVERSATION_TURN_FINISHED`*= 9* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_CONVERSATION_TURN_FINISHED "Permalink to this definition") : The Assistant finished the current turn. This includes both processing a user's query and speaking the full response, if any. | Parameters: | **with_follow_on_turn** (*bool*) -- If True, the Assistant is expecting a follow up interaction from the user. The microphone will be re-opened to allow the user to answer a follow-up question. | |---|---| `ON_CONVERSATION_TURN_STARTED`*= 1* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_CONVERSATION_TURN_STARTED "Permalink to this definition") : Indicates a new turn has started. The Assistant is currently listening, waiting for a user query. This could be the result of hearing the hotword or [`start_conversation()`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start_conversation "google.assistant.library.Assistant.start_conversation") being called on the Assistant. `ON_CONVERSATION_TURN_TIMEOUT`*= 2* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_CONVERSATION_TURN_TIMEOUT "Permalink to this definition") : The Assistant timed out waiting for a discernable query. This could be caused by a mistrigger of the Hotword or the Assistant could not understand what the user said. `ON_DEVICE_ACTION`*= 14* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_DEVICE_ACTION "Permalink to this definition") : Indicates that a [Device Action](https://developers.google.com/assistant/sdk/device-actions-overview) request was dispatched to the device. This is dispatched if any Device Grammar is triggered for the [traits](https://developers.google.com/assistant/sdk/reference/traits/) supported by the device. This event type has a special 'actions' property which will return an iterator or Device Action commands and the params associated with them (if applicable). | Parameters: | **dict** -- The decoded JSON payload of a Device Action request. | |---|---| `ON_END_OF_UTTERANCE`*= 3* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_END_OF_UTTERANCE "Permalink to this definition") : The Assistant has stopped listening to a user query. The Assistant may not have finished figuring out what the user has said but it has stopped listening for more audio data. `ON_MEDIA_STATE_ERROR`*= 20* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_STATE_ERROR "Permalink to this definition") : Indicates that an error has occurred playing a track. The built-in media player will attempt to skip to the next track or return to [`ON_MEDIA_STATE_IDLE`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_STATE_IDLE "google.assistant.library.event.EventType.ON_MEDIA_STATE_IDLE") if there is nothing left to play. `ON_MEDIA_STATE_IDLE`*= 16* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_STATE_IDLE "Permalink to this definition") : Indicates that there is nothing playing and nothing queued to play. This event is broadcast from the Google Assistant Library's built-in media player for news/podcast on start-up and whenever the player has gone idle because a user stopped the media or paused it and the stream has timed out. `ON_MEDIA_TRACK_LOAD`*= 17* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_LOAD "Permalink to this definition") : Indicates a track is loading but has not started playing. This may be dispatched multiple times if new metadata is loaded asynchronously. This is typically followed by the event [`ON_MEDIA_TRACK_PLAY`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY "google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY") | Parameters: | - **metadata** (*dict* ) -- Metadata for the loaded track. Not all fields will be filled by this time -- if a field is unknown it will not be included. Metadata fields include: > album(str): The name of the album the track belongs to. album_art(str): A URL for the album art. artist(str): The artist who created this track. duration_ms(double): The length of this track in milliseconds. title(str): The title of the track. - **track_type** ([*MediaTrackType*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaTrackType "google.assistant.library.event.MediaTrackType")) -- The type of track loaded. | |---|---| `ON_MEDIA_TRACK_PLAY`*= 18* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY "Permalink to this definition") : Indicates that a track is currently outputting audio. This will only trigger when we transistion from one state to another, such as from [`ON_MEDIA_TRACK_LOAD`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_LOAD "google.assistant.library.event.EventType.ON_MEDIA_TRACK_LOAD") or [`ON_MEDIA_TRACK_STOP`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_STOP "google.assistant.library.event.EventType.ON_MEDIA_TRACK_STOP") | Parameters: | - **metadata** (*dict* ) -- Metadata for the playing track. If a field is unknown it will not be included. Metadata fields include: > album(str): The name of the album the track belongs to. album_art(str): A URL for the album art. artist(str): The artist who created this track. duration_ms(double): The length of this track in milliseconds. title(str): The title of the track. - **position_ms** (*double*) -- The current position in a playing track in milliseconds since the beginning. If "metadata.duration_ms" is unknown (set to 0) this field will not be set. - **track_type** ([*MediaTrackType*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaTrackType "google.assistant.library.event.MediaTrackType")) -- The type of track playing. | |---|---| `ON_MEDIA_TRACK_STOP`*= 19* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_STOP "Permalink to this definition") : Indicates that a previously playing track is stopped. This is typically a result of the user pausing; the track can return to [`ON_MEDIA_TRACK_PLAY`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY "google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY") if it is resumed by the user. | Parameters: | - **metadata** (*dict* ) -- Metadata for the stopped track. If a field is unknown it will not be included. Metadata fields include: > album(str): The name of the album the track belongs to. album_art(str): A URL for the album art. artist(str): The artist who created this track. duration_ms(double): The length of this track in milliseconds. title(str): The title of the track. - **position_ms** (*double*) -- The current position in a stopped track in milliseconds since the beginning. If "metadata.duration_ms" is unknown (set to 0) this field will not be set. - **track_type** ([*MediaTrackType*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaTrackType "google.assistant.library.event.MediaTrackType")) -- The type of track stopped. | |---|---| `ON_MUTED_CHANGED`*= 13* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MUTED_CHANGED "Permalink to this definition") : Indicates that the Assistant is currently listening or not. [`start()`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.Assistant.start "google.assistant.library.Assistant.start") will always generate an [`ON_MUTED_CHANGED`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MUTED_CHANGED "google.assistant.library.event.EventType.ON_MUTED_CHANGED") to report the initial value. | Parameters: | **is_muted** (*bool*) -- If True then the Assistant is not currently listening for its hotword and will not respond to user queries. | |---|---| `ON_NO_RESPONSE`*= 8* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_NO_RESPONSE "Permalink to this definition") : The Assistant successfully completed its turn but has nothing to say. `ON_RECOGNIZING_SPEECH_FINISHED`*= 5* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_RECOGNIZING_SPEECH_FINISHED "Permalink to this definition") : The Assistant has determined the final recognized speech. | Parameters: | **text** (*str*) -- The final text interpretation of a user's query. | |---|---| `ON_RENDER_RESPONSE`*= 15* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_RENDER_RESPONSE "Permalink to this definition") : Indicates that the Assistant has text output to render for a response. | Parameters: | - **type** ([*RenderResponseType*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.RenderResponseType "google.assistant.library.event.RenderResponseType")) -- The type of response to render. - **text** (*str*) -- The string to render for RenderResponseType.TEXT. | |---|---| `ON_RESPONDING_FINISHED`*= 7* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_RESPONDING_FINISHED "Permalink to this definition") : The Assistant has finished responding by voice. `ON_RESPONDING_STARTED`*= 6* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_RESPONDING_STARTED "Permalink to this definition") : The Assistant is starting to respond by voice. The Assistant will be responding until [`ON_RESPONDING_FINISHED`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_RESPONDING_FINISHED "google.assistant.library.event.EventType.ON_RESPONDING_FINISHED") is received. | Parameters: | **is_error_response** (*bool*) -- True means a local error TTS is being played, otherwise the Assistant responds with a server response. | |---|---| `ON_START_FINISHED`*= 0* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_START_FINISHED "Permalink to this definition") : The Assistant library has finished starting. *class* `google.assistant.library.event.``IterableEventQueue`(*timeout=3600* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.IterableEventQueue "Permalink to this definition") : Extends queue.Queue to add an `__iter__` interface. `offer`(*event* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.IterableEventQueue.offer "Permalink to this definition") : Offer an event to put in the queue. If the queue is currently full the event will be logged but not added. | Parameters: | **event** ([*Event*](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.Event "google.assistant.library.event.Event")) -- The event to try to add to the queue. | |---|---| *class* `google.assistant.library.event.``MediaStateChangeEvent`(*event_type* , *args* , *\*\*_* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaStateChangeEvent "Permalink to this definition") : Extends Event to add parsing of 'state'. *class* `google.assistant.library.event.``MediaTrackType`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaTrackType "Permalink to this definition") : Types of track for an ON_MEDIA_TRACK_X events. Used with [`ON_MEDIA_TRACK_LOAD`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_LOAD "google.assistant.library.event.EventType.ON_MEDIA_TRACK_LOAD"), [`ON_MEDIA_TRACK_PLAY`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY "google.assistant.library.event.EventType.ON_MEDIA_TRACK_PLAY"), \& [`ON_MEDIA_TRACK_STOP`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_MEDIA_TRACK_STOP "google.assistant.library.event.EventType.ON_MEDIA_TRACK_STOP") `CONTENT`*= 2* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaTrackType.CONTENT "Permalink to this definition") : The actual content for an item (news/podcast). `TTS`*= 1* [¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.MediaTrackType.TTS "Permalink to this definition") : A TTS introduction or interstitial track related to an item. *class* `google.assistant.library.event.``RenderResponseEvent`(*event_type* , *args* , *\*\*_* )[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.RenderResponseEvent "Permalink to this definition") : Extends Event to add parsing of 'response_type'. *class* `google.assistant.library.event.``RenderResponseType`[¶](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.RenderResponseType "Permalink to this definition") : Types of content to render. Used with [`ON_RENDER_RESPONSE`](https://developers.google.com/assistant/sdk/reference/library/python#google.assistant.library.event.EventType.ON_RENDER_RESPONSE "google.assistant.library.event.EventType.ON_RENDER_RESPONSE")