{"id":35761963,"url":"https://github.com/bieniu/ha-perplexity","last_synced_at":"2026-04-02T18:26:29.610Z","repository":{"id":331652905,"uuid":"1129270146","full_name":"bieniu/ha-perplexity","owner":"bieniu","description":"Perplexity integration for Home Assistant","archived":false,"fork":false,"pushed_at":"2026-02-11T07:51:50.000Z","size":130,"stargazers_count":23,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-02-11T13:22:34.235Z","etag":null,"topics":["ai","ai-task","hass","home-assistant","perplexity","sonar"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bieniu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://www.paypal.me/bieniu79","https://www.buymeacoffee.com/QnLdxeaqO","https://revolut.me/maciejbieniek"]}},"created_at":"2026-01-06T21:17:14.000Z","updated_at":"2026-02-11T07:51:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bieniu/ha-perplexity","commit_stats":null,"previous_names":["bieniu/ha-perplexity"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/bieniu/ha-perplexity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bieniu%2Fha-perplexity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bieniu%2Fha-perplexity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bieniu%2Fha-perplexity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bieniu%2Fha-perplexity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bieniu","download_url":"https://codeload.github.com/bieniu/ha-perplexity/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bieniu%2Fha-perplexity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29480862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T11:35:25.641Z","status":"ssl_error","status_checked_at":"2026-02-15T11:34:57.128Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-task","hass","home-assistant","perplexity","sonar"],"created_at":"2026-01-06T23:21:35.812Z","updated_at":"2026-04-02T18:26:29.597Z","avatar_url":"https://github.com/bieniu.png","language":"Python","funding_links":["https://www.paypal.me/bieniu79","https://www.buymeacoffee.com/QnLdxeaqO","https://revolut.me/maciejbieniek"],"categories":[],"sub_categories":[],"readme":"[![CI](https://img.shields.io/github/actions/workflow/status/bieniu/ha-perplexity/ci.yml?branch=master\u0026label=CI\u0026logo=github\u0026style=popout)](https://github.com/bieniu/ha-perplexity/actions/workflows/ci.yml?query=branch%3Amaster)\n[![Validate with hassfest](https://github.com/bieniu/ha-perplexity/actions/workflows/hassfest.yml/badge.svg)](https://github.com/bieniu/ha-perplexity/actions/workflows/hassfest.yml)\n[![codecov](https://codecov.io/gh/bieniu/ha-perplexity/graph/badge.svg?token=SJD4N4CKH6)](https://codecov.io/gh/bieniu/ha-perplexity)\n[![GitHub Release][releases-shield]][releases]\n[![GitHub All Releases][downloads-total-shield]][releases]\n[![Buy me a coffee][buy-me-a-coffee-shield]][buy-me-a-coffee]\n[![PayPal_Me][paypal-me-shield]][paypal-me]\n[![Revolut.Me][revolut-me-shield]][revolut-me]\n\n# Perplexity\nPerplexity integration for Home Assistant.\n\n\u003cimg width=\"1032\" height=\"742\" alt=\"obraz\" src=\"https://github.com/user-attachments/assets/5b286300-ce24-46c6-86e2-e214cabc044d\" /\u003e\n\n## Installation\n\nYou can install this integration manually or via [HACS](https://hacs.xyz).\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=bieniu\u0026repository=ha-perplexity\u0026category=integration)\n\n## Configuration\n\nTo configure integration in Home Assistant, go to **Settings** \u003e\u003e **Devices \u0026 services** \u003e\u003e **Add integration** \u003e\u003e **Perplexity** or use My Home Assistant link.\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=perplexity)\n\nTo generate API key go to [https://www.perplexity.ai/account/api/keys](https://www.perplexity.ai/account/api/keys)\n\nNow you can add Perplexity conversation agent or AI task configuration.\n\n\u003cimg width=\"1031\" height=\"116\" alt=\"obraz\" src=\"https://github.com/user-attachments/assets/a8ef5247-93d8-4ff7-9186-0136bc1eeb8f\" /\u003e\n\nTo configure Perplexity as a conversation agent for you Voice assistant:\n\n- Go to **Settings** \u003e\u003e **Voice assistants** or use My Home Assistant link.\n\n  [![Open your Home Assistant instance and show your voice assistants.](https://my.home-assistant.io/badges/voice_assistants.svg)](https://my.home-assistant.io/redirect/voice_assistants/)\n- Select **Add assistant**.\n- Enter the assistant's name and select one of the Perplexity models as the **Conversation agent**.\n- Now you can customize your conversation agent settings.\n\n  \u003cimg width=\"606\" height=\"554\" alt=\"obraz\" src=\"https://github.com/user-attachments/assets/94dc1193-9f60-49ed-b6a6-eb376405b3bf\" /\u003e\n\n- You can use the Perplexity AI task for AI suggestions in the Home Assistant interface. Go to **Settings** \u003e\u003e **General**.\n\n  \u003cimg width=\"607\" height=\"421\" alt=\"obraz\" src=\"https://github.com/user-attachments/assets/aae705c7-59cd-4709-9ba8-cf20061dcb97\" /\u003e\n\n## Features\n\nPerplexity integration supports:\n\n- [Conversation](https://www.home-assistant.io/integrations/conversation/) platform (beta)\n- [AI Task](https://www.home-assistant.io/integrations/ai_task/) platform\n- **Sonar**, **Sonar Pro** and **Sonar Reasoning Pro** models\n- **reasoning effort** configuration (for models supporting reasoning)\n- controlling **web search** option\n- delayed actions - you can ask the assistant to perform an action (for example, turn on the light) after some time or at a specific time\n- timers\n\n## AI Task examples\n\n### Generating a short description of weather conditions\n\n```yaml\naction: ai_task.generate_data\ndata:\n  task_name: Weather Description\n  entity_id: ai_task.sonar\n  instructions: \u003e-\n    Based on this {{ states.weather.home }} and an image create short weather\n    description (ONLY ONE SENTENCE).\n```\n\nResponse:\n\n```\nThe sky is overcast with dark, ragged clouds on this chilly January morning, threatening rain and a brisk wind.\n```\n\n### Counting objects from a camera snapshot\n\n```yaml\naction: ai_task.generate_data\ndata:\n  task_name: Number of cars\n  entity_id: ai_task.sonar\n  instructions: In the attached photo, count the cars in the parking lot.\n  attachments:\n    media_content_id: media-source://camera/camera.parking\n    media_content_type: application/vnd.apple.mpegurl\n    metadata:\n      title: parking\n      thumbnail: /api/camera_proxy/camera.parking\n      media_class: video\n      navigateIds:\n        - media_content_type: app\n          media_content_id: media-source://camera\n  structure:\n    car_count:\n      required: true\n      selector:\n        number:\n```\n\nResponse:\n\n```yaml\ndata:\n  car_count: 42\n```\n\n## How to debug\n\nTo debug the integration add this to your `logger` configuration:\n\n```yaml\n# configuration.yaml file\nlogger:\n  default: warning\n  logs:\n    custom_components.perplexity: debug\n    perplexity: debug\n```\n\n## How to create a dev environment\n\n```bash\ngit clone https://github.com/bieniu/ha-perplexity.git\ncd ha-perplexity\nscripts/setup-local-env.sh\n```\n\n[releases]: https://github.com/bieniu/ha-perplexity/releases\n[releases-shield]: https://img.shields.io/github/release/bieniu/ha-perplexity.svg?style=popout\n[downloads-total-shield]: https://img.shields.io/github/downloads/bieniu/ha-perplexity/total\n[buy-me-a-coffee-shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=Buy%20me%20a%20coffee\u0026color=6f4e37\u0026logo=buy%20me%20a%20coffee\u0026logoColor=white\n[buy-me-a-coffee]: https://www.buymeacoffee.com/QnLdxeaqO\n[paypal-me-shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=PayPal.Me\u0026logo=paypal\n[paypal-me]: https://www.paypal.me/bieniu79\n[revolut-me]: https://revolut.me/maciejbieniek\n[revolut-me-shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=Revolut\u0026logo=revolut\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbieniu%2Fha-perplexity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbieniu%2Fha-perplexity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbieniu%2Fha-perplexity/lists"}