{"id":50033969,"url":"https://github.com/berkansezer77/pom_tesla_report","last_synced_at":"2026-05-25T03:01:46.932Z","repository":{"id":359159134,"uuid":"1242635216","full_name":"berkansezer77/pom_tesla_report","owner":"berkansezer77","description":"Turn your Tesla into an AI-powered Home Assistant companion with Telegram chat, smart controls, trip reports, and maps.","archived":false,"fork":false,"pushed_at":"2026-05-21T19:31:24.000Z","size":2106,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T01:03:26.218Z","etag":null,"topics":["ai","automation","custom-component","hacs","home-assistant","telegram","tesla"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/berkansezer77.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2026-05-18T15:54:33.000Z","updated_at":"2026-05-21T19:31:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/berkansezer77/pom_tesla_report","commit_stats":null,"previous_names":["berkansezer77/pom_tesla_report"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/berkansezer77/pom_tesla_report","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berkansezer77%2Fpom_tesla_report","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berkansezer77%2Fpom_tesla_report/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berkansezer77%2Fpom_tesla_report/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berkansezer77%2Fpom_tesla_report/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/berkansezer77","download_url":"https://codeload.github.com/berkansezer77/pom_tesla_report/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berkansezer77%2Fpom_tesla_report/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33418550,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","automation","custom-component","hacs","home-assistant","telegram","tesla"],"created_at":"2026-05-20T23:07:15.114Z","updated_at":"2026-05-24T02:00:26.596Z","avatar_url":"https://github.com/berkansezer77.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# POM Tesla AI\n\n\u003c!-- AUTO:BADGES_START --\u003e\nVersion: 2.1.1-beta.1 | Last updated: 2026-05-18\n\u003c!-- AUTO:BADGES_END --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/tesla1.png\" alt=\"POM Tesla AI logo\" width=\"140\"\u003e\n\u003c/p\u003e\n\nTurn your Tesla into an AI-powered assistant. Through Home Assistant and Telegram, you get a companion that can chat with you, explain vehicle details, and provide access to driving-related controls. It is more than chat: it can also send trip and charging reports to Telegram manually or automatically. The integration also includes a live driving card so you can monitor key trip data during a drive. Instead of handing over your Tesla account directly, you can authorize specific users for driving workflows through Tesla AI.\n\n\u003e Beta status: this integration can send real commands to your vehicle. Start with read-only status questions, then test safe commands, and only enable risky controls when you understand the confirmation flow.\n\n## What It Does\n\nPOM Tesla AI is a custom Home Assistant integration built around a Tesla-focused AI assistant. It combines vehicle telemetry, Telegram conversation, curated vehicle-control capabilities, trip reports, charging reports, and route maps.\n\nMain features:\n\n- AI-powered Telegram assistant for natural Turkish vehicle conversations\n- Capability-based vehicle control router\n- Telegram confirmation buttons and text confirmations\n- Manual entity selection for report data and AI context\n- Drive/trip PNG reports\n- Charging session summaries\n- Optional route map collection and separate map image sending\n- Vehicle Entity Manager for report, AI, map, and alert usage\n- AI alerts and watcher-style notifications\n- Test/simulation tools for trip report validation\n\n## Installation\n\n### Manual Installation\n\n1. Download or clone this repository.\n2. Copy this folder:\n\n```text\ncustom_components/pom_tesla_report\n```\n\nto your Home Assistant config folder:\n\n```text\n/config/custom_components/pom_tesla_report\n```\n\n3. Restart Home Assistant.\n4. Go to Settings \u003e Devices \u0026 services.\n5. Add integration: `POM Tesla Report`.\n\n### HACS Custom Repository\n\nThis beta can also be added as a HACS custom repository:\n\n1. HACS \u003e Integrations \u003e three-dot menu \u003e Custom repositories\n2. Repository:\n\n```text\nhttps://github.com/berkansezer77/pom_tesla_report\n```\n\n3. Category: Integration\n4. Download `POM Tesla Report`\n5. Restart Home Assistant\n\n### Lovelace Resource Setup (Beta)\n\nIf the dashboard card does not appear automatically, add the card resource manually:\n\n1. Home Assistant \u003e Settings \u003e Dashboards \u003e three-dot menu \u003e Resources\n2. Add resource URL:\n\n```text\n/local/community/pom_tesla_report/pom-tesla-dashboard-card.js\n```\n\n3. Resource type: `JavaScript Module`\n4. Save and reload the dashboard\n\n## First Setup\n\nPOM Tesla Report intentionally ships without your personal entity IDs. A new user must select entities manually.\n\nAt minimum, configure:\n\n- Battery level sensor\n- Speed sensor\n- Odometer sensor\n- Shift state sensor\n- Climate entity\n- Charging status entity\n- Charge energy added sensor\n- Location tracker for maps, if you want trip maps\n- Telegram target, if you want Telegram messages\n- OpenAI API key, if you want AI chat and AI control routing\n\n## Vehicle Entity Manager\n\nThe Vehicle Entity Manager is the central place where you tell POM what each entity is allowed to do.\n\nEach entity can be marked for one or more uses:\n\n- Report: used in trip and charging reports\n- AI: included in AI context\n- Map: used for route tracking\n- Alerts: used by AI alert/watch logic\n\nThis separation is important. A sensor can be useful for reports but not for AI, or useful for AI but not for maps.\n\n## AI Telegram Assistant\n\nThe Telegram listener no longer requires a prefix. You can write directly:\n\n```text\nsentry acik mi?\narac uyanik mi?\nsarj oluyor mu?\ncok sicak\nklimayi ac\n```\n\nIf you still write `POM klimayi ac`, it is accepted as a legacy style, but it is not required.\n\n## Vehicle Controls and Confirmations\n\nPOM uses a curated capability manifest instead of guessing entity IDs. The AI chooses a capability, and the code maps that capability to your selected entity.\n\nExamples:\n\n```text\nsentry mode ac\nklimayi kapat\nkorna cal\ncamlari kapat\nbagaji ac\n```\n\nRisky actions can require confirmation. Telegram confirmation supports both:\n\n- Inline buttons: Onayla / Iptal\n- Text replies: evet, tamam, onayliyorum, onay veriyorum, iptal\n\nIf there is no real pending action and you write `onayliyorum`, POM will not pretend to execute anything. It will tell you that there is no pending vehicle-control approval.\n\n## Trip Reports\n\nTrip reports are generated from the report entities you selected. The integration does not include any personal report history.\n\nTypical report inputs:\n\n- Start and end odometer\n- Battery level\n- Energy remaining\n- Speed / shift state\n- Climate state\n- Route points, when trip map collection is enabled\n\nExample output image:\n\n\u003cimg src=\"docs/images/trip-report.jpg\" alt=\"Trip Report\" width=\"420\"\u003e\n\n## Trip Maps\n\nTrip map collection is optional.\n\nSettings:\n\n- Enable trip map collection\n- Trip map tracker entity\n- Map sample interval seconds\n- Minimum movement meters\n- Send separate trip map PNG\n\nIf `Send separate trip map PNG` is disabled, POM will not send the map as a second Telegram image after the trip report.\n\nExample output image:\n\n\u003cimg src=\"docs/images/map-report.jpg\" alt=\"Trip Map\" width=\"420\"\u003e\n\n## Charging Reports\n\nCharging reports can summarize sessions with:\n\n- Added energy\n- Duration\n- Provider pricing\n- Estimated or manually confirmed cost\n- Telegram prompt flow for real charging cost\n\nExample output image:\n\n\u003cimg src=\"docs/images/charger-report.jpg\" alt=\"Charging Report\" width=\"420\"\u003e\n\n## AI Alerts\n\nAI alerts can watch selected entities and notify you about important vehicle states such as:\n\n- Low battery\n- Charging stopped\n- Tire pressure concerns\n- High battery temperature\n- Unlocked vehicle\n- Door/window open conditions\n\n## Test and Simulation Tools\n\nThe integration includes test/simulation tools for validating trip/report behavior without needing to drive the car every time.\n\nThese tools are useful for beta testing and development. Normal users do not need them during daily use.\n\n## Recommended Data Source\n\nFor best results, use this integration together with either Tessie or TeslaMate.\n\nAt least one of these data providers is required. Their telemetry and control entities are what power the AI assistant, reporting pipeline, and vehicle-control workflows.\n\n## Privacy and Safety\n\nThis repository does not include:\n\n- Personal Telegram chat IDs\n- Personal Home Assistant entity IDs\n- API keys\n- Generated report PNG files\n- Route history\n- Vehicle logs\n\nYou must configure your own entities and credentials after installation.\n\n## Beta Notes\n\nThis is a beta release. Before relying on vehicle controls:\n\n1. Test read-only questions first.\n2. Test non-risky commands.\n3. Test confirmation flow.\n4. Confirm that the Vehicle Entity Manager maps the right entity to each capability.\n5. Keep optional confirmation enabled if you want a more cautious setup.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberkansezer77%2Fpom_tesla_report","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fberkansezer77%2Fpom_tesla_report","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberkansezer77%2Fpom_tesla_report/lists"}