Home AssistantHome AssistantContributors
On this page

Home Assistant is spread over many repositories, most of them in the home-assistant organization on GitHub. You'll work in one or two of them. This page tells you which.

The main ones

Repository Holds Language
core Home Assistant Core and every built-in integration Python
frontend The web interface, the component gallery, and the demo TypeScript
android The Android app, for phones, Wear OS, and cars Kotlin
iOS The app for iPhone, iPad, Mac, Apple Watch, and CarPlay Swift
supervisor The Supervisor Python
operating-system Home Assistant OS Buildroot, shell

Documentation and design

Repository Holds
home-assistant.io The user documentation, including a page per integration
companion.home-assistant The documentation of the companion apps
brands Logos and icons of integrations
architecture Architecture discussions and decisions, see how decisions are made

Around the Supervisor

Repository Holds
addons The official apps
apps-example An example to start an app from
cli The ha command line
os-agent The helper on the host of Home Assistant OS
docker-base The base images for Home Assistant and apps
plugin-dns, plugin-audio, plugin-cli, plugin-multicast, plugin-observer The Supervisor's plugins

Libraries

Repository Holds
home-assistant-js-websocket The JavaScript client for the WebSocket API
home-assistant-libs An organization with Python libraries maintained by the project, like the Supervisor client
OHF-Voice Voice projects of the Open Home Foundation, like the sentences Assist understands

Where to go for what

You want to Go to
Fix a bug in an integration core
Add a new integration core, then home-assistant.io for its documentation, and brands for its logo
Change something in the UI frontend, or core if it is text of an integration
Fix documentation home-assistant.io
Report a bug The repository of the part that has the bug. Not sure? Ask on Discord.
Suggest a feature The feature requests discussions

Work on this

Every repository above belongs to an area of this site, which explains how to make your first change there. See Ready to contribute? for the map.

Was this page helpful?

Last updated on .