Versatile Thermostat
A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management.
https://github.com/jmcollin78/versatile_thermostat
Category: Consumption
Sub Category: Buildings and Heating
Keywords
hacs-custom hacs-integration home-assistant python thermostat
Keywords from Contributors
hacs sensor varta varta-storage integration solar
Last synced: about 17 hours ago
JSON representation
Repository metadata
A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management
- Host: GitHub
- URL: https://github.com/jmcollin78/versatile_thermostat
- Owner: jmcollin78
- License: mit
- Created: 2022-12-27T09:48:13.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2026-09-06T14:30:30.000Z (7 days ago)
- Last Synced: 2026-09-10T09:10:50.931Z (3 days ago)
- Topics: hacs-custom, hacs-integration, home-assistant, python, thermostat
- Language: Python
- Homepage: https://www.versatile-thermostat.org/
- Size: 17.6 MB
- Stars: 1,170
- Watchers: 13
- Forks: 141
- Open Issues: 19
- Releases: 336
-
Metadata Files:
- Readme: README-cs.md
- Contributing: CONTRIBUTING-cs.md
- License: LICENSE
- Copilot: .github/copilot-instructions.md
README-cs.md
Versatile Thermostat
Tento README soubor je k dispozici v následujících
jazycích: Angličtina | Francouzština | Němčina | Čeština
Versatile Thermostat je vysoce konfigurovatelný virtuální termostat, který transformuje jakékoli vytápěcí zařízení (radiátory, klimatizace, tepelná čerpadla atd.) v inteligentní a adaptivní systém. Umožňuje vám konsolidovat a centrálně řídit více různých topných systémů, přičemž automaticky optimalizuje spotřebu energie. Díky pokročilým algoritmům (TPI, auto-TPI) a možnostem učení se termostat přizpůsobuje vašemu domu 🏠 a vašim zvykům, poskytuje optimální pohodlí a významné snížení vašich topných účtů 💰.
Tato termostatická integrace má za cíl výrazně zjednodušit vaše automatizace kolem správy vytápění. Protože všechny typické události kolem vytápění (nikdo doma?, detekována aktivita v místnosti?, otevřené okno?, omezení spotřeby energie?) jsou nativně spravovány termostatem, nemusíte se zabývat komplikovanými skripty a automatizacemi pro správu vašich termostatů. 😉
Tato vlastní komponenta pro Home Assistant je vylepšením a kompletním přepsáním komponenty "Awesome thermostat" (viz Github) s přidanými funkcemi.
Snímky obrazovky
Versatile Thermostat UI Card (K dispozici na Github) :

Co je nového?
![]()
Verze 10.1
Výběr režimu zastavení pro automatické spuštění/zastavení. Nová entita select umožňuje zvolit režim použitý, když funkce automatického spuštění/zastavení zjistí podmínku zastavení: Vypnuto (výchozí), Pouze ventilátor nebo Vysoušení. Režimy Pouze ventilátor a Vysoušení jsou nabízeny pouze tehdy, pokud je podřízené zařízení podporuje. Více informací zde.
Samo-regulace je nyní vypnuta, když VTherm typu over_climate není v režimu Topení nebo Chlazení: podkladovému zařízení je odeslán původní (neregulovaný) setpoint. Více informací zde.
Verze 10.0
Zavedení mechanismu pluginů. Umožňuje používat externí integrace jako pluginy pro VTherm. Seznam dostupných pluginů je na webu Versatile Thermostat.
Verze 9.3 (stabilní)
- Detekce zaseknutého ventilu: významné vylepšení detekce poruch vytápění. Při anomálii u VTherm typu
over_climate_valvetermostat diagnostikuje, zda je příčinou zaseknutý TRV ventil (zaseknutý otevřený/zavřený), a pošleroot_causev události. Více informací zde,- Automatické opětovné zamčení po odemčení: přidán parametr
auto_relock_secve funkci zámku. Při nastavení se termostat po odemčení automaticky znovu zamkne po zadaném počtu sekund. Více informací zde,- Opětovné odeslání příkazu: nová funkce, která detekuje a opravuje nesoulad mezi požadovaným stavem termostatu a skutečným stavem podřízených zařízení. Pokud se příkaz neprovede správně, odešle se znovu. Více informací zde,
- Obnovení časovaného presetu po restartu: časovaný preset se po restartu termostatu nebo Home Assistant obnoví a pokračuje normálně. Více informací zde,
- Přesnější řízení výkonu: práh aktivace kotle (
power_activation_threshold) nově přijímá desetinné hodnoty (0.1, 0.5, ...), což umožňuje jemnější řízení spotřeby. Více informací zde,- Zlepšení dostupnosti senzorů: lepší určování dostupnosti teplotních senzorů přes metadata
last_updatedv Home Assistant.
Verze 9.2
- Nový způsob řízení cyklů topení/zastavení pro VTherm
over_switch. Současný algoritmus má časový drift a první cykly nejsou optimální. To narušuje TPI a zejména auto-TPI. NovýCycle Schedulerřeší tyto potíže. Tato změna je pro vás zcela transparentní,- Kolektor záznamů. Vaše žádosti o podporu často selhávají kvůli vaší schopnosti poskytnout záznamy v správném období, zaměřené na termostat s chybou a na správné úrovni záznamů. Jedná se zejména o obtížně reprodukovatelné chyby. Kolektor záznamů má za cíl vyřešit tuto potíž. Sbírá pro vás záznamy na pozadí na nejjemnější úrovni a akce (dříve služba) umožňuje jejich extrakci do souboru. Poté je můžete stáhnout a připojit k vaší žádosti o podporu. Analyzátor záznamů spojený s webovými stránkami – spuštěný ve verzi 9.1 (viz níže) – se přizpůsobuje, aby mohl tyto záznamy zpracovat. Více informací o kolektoru záznamů zde,
- Stabilizace verze 9.x. Hlavní verze 9 přinesla mnoho změn, které způsobily některé anomálie. Tato verze přináší poslední opravy týkající se verze 9.
Verze 9.1
- Nové logo. Inspirováno prací @Krzysztonek (viz zde), VTherm využívá novou funkci představenou v HA 206.03 pro změnu svého loga. Celý tým doufá, že se vám bude líbit. Užijte si to!
- Webová stránka vytvořená @bontiv řeší jeden z hlavních problémů VTherm: dokumentaci. Tato stránka navíc umožňuje analyzovat vaše logy! Poskytněte své logy (v debug režimu) a budete je moci analyzovat, přiblížit konkrétní termostat, zaměřit se na určité období, filtrovat to, co vás zajímá, atd. Objevte tuto první verzi zde: Versatile Thermostat Web site. Velké poděkování patří @bontiv za tuto skvělou práci.
- Oficiální vydání funkce auto-TPI. Tato funkce vypočítává optimální hodnoty koeficientů pro algoritmus TPI. Je třeba ocenit neuvěřitelnou práci @KipK a @gael1980 na tomto tématu. Pokud ji chcete používat, určitě si přečtěte dokumentaci.
- VTherm se nyní opírá o stav hlášený podřízenými zařízeními v HA. Dokud všechna podřízená zařízení nemají v HA známý stav, VTherm zůstává deaktivovaný.
🍻 Děkuji za piva 🍻
Velké díky všem mým donátorům za jejich příspěvky a povzbuzování. Je to pro mě velmi potěšující a motivuje mě to pokračovat! Pokud vám tato integrace pomohla ušetřit, kupte mi malé pivo na oplátku, budu vám velmi vděčný!
Slovník
VTherm : Versatile Thermostat v následujícím textu tohoto dokumentu
TRV : termostatická hlavice vybavená ventilem. Ventil se otevírá nebo zavírá, čímž umožňuje průchod teplé vody
AC : klimatizace. Zařízení je AC, pokud chladí. Teploty jsou pak obrácené: Eco je teplejší než Komfort, který je teplejší než Boost. Algoritmy tuto informaci berou v úvahu.
EMA : Exponential Moving Average. Používá se k vyhlazení měření teplot senzorů. Odpovídá klouzavému průměru teploty místnosti. Používá se k výpočtu sklonu křivky teploty (slope), který by byl na surové křivce příliš nestabilní.
slope : sklon křivky teploty. Měří se v °(C nebo K)/h. Je pozitivní, pokud teplota stoupá, a negativní, pokud klesá. Tento sklon se počítá na EMA
PAC : tepelné čerpadlo
HA : Home Assistant
underlying: zařízení ovládané VTherm
Dokumentace
Dokumentace je nyní rozdělena do několika stránek pro snadnější čtení a vyhledávání:
- Úvod
- Instalace
- Rychlý start
- Výběr typu VTherm
- Základní atributy
- Konfigurace VTherm na
spínači - Konfigurace VTherm na
klimatizaci - Konfigurace VTherm na ventilu
- Předvolby
- Správa oken
- Správa přítomnosti
- Správa pohybu
- Správa energie
- Auto start a stop
- Centralizované řízení všech VTherm
- Řízení ústředního vytápění
- Pokročilé aspekty, bezpečnostní režim
- Detekce poruchy vytápění
- Samoregulace
- Auto TPI učení
- Algoritmy
- Zamknutí / odemknutí
- Synchronizace teploty
- Časovaný preset
- Referenční dokumentace
- Příklady ladění
- Řešení problémů
- Poznámky k verzím
Některé výsledky
Stabilita teploty kolem cíle nakonfigurovaného předvolbou:

Cykly zapnutí/vypnutí vypočítané integrací over_climate:

Regulace s over_switch:

Silná regulace v over_climate:

Regulace s přímým řízením ventilu v over_climate:

Některé komentáře k integraci
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Užijte si to!
⭐ Historie hvězdiček
Příspěvky jsou vítány!
Pokud si přejete přispět, přečtěte si prosím pokyny pro přispívání.
Owner metadata
- Name: Jean-Marc Collin
- Login: jmcollin78
- Email:
- Kind: user
- Description:
- Website: http://clouderial.com
- Location: France
- Twitter:
- Company: Clouderial
- Icon url: https://avatars.githubusercontent.com/u/1712374?u=28dcf780c3c2043f176ba88bea0b0135c6f6670b&v=4
- Repositories: 13
- Last ynced at: 2023-09-20T14:50:26.970Z
- Profile URL: https://github.com/jmcollin78
GitHub Events
Total
- Commit comment event: 4
- Create event: 170
- Delete event: 116
- Discussion event: 64
- Fork event: 56
- Issue comment event: 2080
- Issues event: 796
- Member event: 1
- Pull request event: 299
- Pull request review comment event: 81
- Pull request review event: 169
- Push event: 618
- Release event: 100
- Watch event: 402
Last Year
- Commit comment event: 2
- Create event: 48
- Delete event: 55
- Discussion event: 64
- Fork event: 17
- Issue comment event: 746
- Issues event: 427
- Member event: 1
- Pull request event: 144
- Pull request review comment event: 63
- Pull request review event: 114
- Push event: 324
- Release event: 27
- Watch event: 147
Committers metadata
Last synced: 1 day ago
Total Commits: 836
Total Committers: 67
Avg Commits per committer: 12.478
Development Distribution Score (DDS): 0.585
Commits in past year: 370
Committers in past year: 36
Avg Commits per committer in past year: 10.278
Development Distribution Score (DDS) in past year: 0.646
| Name | Commits | |
|---|---|---|
| Jean-Marc Collin | j****n@r****m | 347 |
| Jean-Marc Collin | j****8@g****m | 271 |
| Guillaume S | K****K | 69 |
| Frank Mainz | f****k@c****e | 21 |
| Krzysztonek | 8****k | 15 |
| Paulo Ferreira de Castro | p****o@g****m | 10 |
| Remi BONNET | b****v | 9 |
| adi90x | a****0@g****m | 7 |
| Gamso | G****o | 6 |
| silviopen | 4****n | 5 |
| Etienne F. | e****e | 4 |
| Gernot Messow | g****r@g****m | 3 |
| misa1515 | 6****5 | 3 |
| jebabin | g****m@j****e | 3 |
| Clément Notin | c****n@g****m | 3 |
| Andrea Nicotra | n****a@g****m | 3 |
| Václav Pokluda | v****a@g****m | 2 |
| KipK | k****k@n****m | 2 |
| Malte Gerken | m****n@g****m | 2 |
| Marco Migozzi | t****z@g****m | 2 |
| Vassilis Papanikolaou | v****k@g****m | 2 |
| hilburn | c****9@g****m | 2 |
| 53l3cu5 | 3****5 | 1 |
| Joeri Colman | c****i@m****m | 1 |
| Ian | i****e | 1 |
| Frederic Seiler | f****c@s****o | 1 |
| Fabio Coatti | f****i@g****m | 1 |
| Eric Scherlinger | 3****e | 1 |
| Edwin ten Haaf | e****n@f****l | 1 |
| EPicLURcher | 7****r | 1 |
| and 37 more... | ||
Committer domains:
- snoe.me: 1
- 23doors.com: 1
- mbinf.de: 1
- hoizey.com: 1
- microsoft.com: 1
- orange.fr: 1
- barbot.org: 1
- jasonhofmann.com: 1
- wanadoo.fr: 1
- oothkoo.com: 1
- dera.page: 1
- familietenhaaf.nl: 1
- seiler.io: 1
- msn.com: 1
- nomal.com: 1
- jeb.be: 1
- cybermainzel.de: 1
- renault.com: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 509
Total pull requests: 302
Average time to close issues: 25 days
Average time to close pull requests: 4 days
Total issue authors: 244
Total pull request authors: 61
Average comments per issue: 4.72
Average comments per pull request: 1.02
Merged pull request: 238
Bot issues: 0
Bot pull requests: 0
Past year issues: 86
Past year pull requests: 60
Past year average time to close issues: 13 days
Past year average time to close pull requests: 10 days
Past year issue authors: 69
Past year pull request authors: 28
Past year average comments per issue: 4.8
Past year average comments per pull request: 1.57
Past year merged pull request: 34
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- jmcollin78 (143)
- maia (13)
- adi90x (10)
- tomtom13 (7)
- kadaan (6)
- jezzaaa (4)
- TTLucian (4)
- Ra72xx (4)
- Bergoglio (4)
- MaxWaldorf (4)
- jiquem (4)
- asdkjasdfla (4)
- vador31 (4)
- mleiber (3)
- Merangle (3)
Top Pull Request Authors
- jmcollin78 (166)
- FMainz (14)
- pdcastro (10)
- adi90x (9)
- KipK (8)
- hilburn (6)
- gpayer (6)
- dark-light-cz (3)
- malteger (3)
- bontiv (3)
- cova-fe (2)
- carlolars (2)
- lboue (2)
- tmad (2)
- felixfischer (2)
Top Issue Labels
- developed (139)
- enhancement (123)
- P1 (111)
- bug (105)
- question (50)
- wontfix (45)
- Not VTherm issue (25)
- invalid (21)
- documentation (20)
- Template not respected (20)
- duplicate (19)
- help wanted (16)
- Waiting response (16)
- Vote needed (13)
- need PR (12)
- not reproduced (10)
- P0 (7)
- P2 (4)
- Experimental (1)
Top Pull Request Labels
- question (2)
- wontfix (1)
Package metadata
- Total packages: 2
- Total downloads: unknown
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 4
- Total maintainers: 1
proxy.golang.org: github.com/jmcollin78/versatile_thermostat
- Homepage:
- Status: removed
- Documentation: https://pkg.go.dev/github.com/jmcollin78/versatile_thermostat#section-documentation
- Licenses: mit
- Latest release: v0.0.0-20260829183848-d78b7d1cee80 (published 14 days ago)
- Last Synced: 2026-09-11T16:02:29.973Z (1 day ago)
- Versions: 1
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 4.384%
- Average: 4.532%
- Dependent repos count: 4.679%
nixpkgs-unstable: home-assistant-custom-components.versatile_thermostat
Full-featured thermostat
- Homepage: https://github.com/jmcollin78/versatile_thermostat
- Documentation: https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/servers/home-assistant/custom-components/versatile_thermostat/package.nix#L31
- Licenses: MIT
- Latest release: 9.0.2 (published 6 months ago)
- Last Synced: 2026-05-14T06:02:24.600Z (4 months ago)
- Versions: 3
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
- Maintainers (1)
Dependencies
- actions/checkout v2 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- hacs/action main composite
- ffmpeg * development
- homeassistant ==2023.10.3 development
- aiodiscover * test
- pytest-asyncio * test
- pytest-homeassistant-custom-component * test
- ulid_transform * test
- actions/checkout v4 composite
- softprops/action-gh-release v2.2.1 composite
- python 3.14-bookworm build
- actions/cache v3 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
Score: 11.285560516081748
Versatile Thermostat je vysoce konfigurovatelný virtuální termostat, který transformuje jakékoli vytápěcí zařízení (radiátory, klimatizace, tepelná čerpadla atd.) v inteligentní a adaptivní systém. Umožňuje vám konsolidovat a centrálně řídit více různých topných systémů, přičemž automaticky optimalizuje spotřebu energie. Díky pokročilým algoritmům (TPI, auto-TPI) a možnostem učení se termostat přizpůsobuje vašemu domu 🏠 a vašim zvykům, poskytuje optimální pohodlí a významné snížení vašich topných účtů 💰.





