mirror of
https://github.com/sudoxnym/ha-addons.git
synced 2026-04-14 19:46:21 +00:00
53 lines
1.7 KiB
Markdown
53 lines
1.7 KiB
Markdown
|
# connectd add-on for home assistant
|
||
|
|
|
||
|
|
find isolated builders with aligned values. auto-discovers humans on github, mastodon, lemmy, discord, and more.
|
||
|
|
|
||
|
|
## installation
|
||
|
|
|
||
|
|
1. add this repository to your home assistant add-on store
|
||
|
|
2. install the connectd add-on
|
||
|
|
3. configure your HOST_USER (github username) in the add-on settings
|
||
|
|
4. start the add-on
|
||
|
|
|
||
|
|
## configuration
|
||
|
|
|
||
|
|
### required
|
||
|
|
- **host_user**: your github username (connectd will auto-discover your profile)
|
||
|
|
|
||
|
|
### optional host info
|
||
|
|
- **host_name**: your display name
|
||
|
|
- **host_email**: your email
|
||
|
|
- **host_mastodon**: mastodon handle (@user@instance)
|
||
|
|
- **host_reddit**: reddit username
|
||
|
|
- **host_lemmy**: lemmy handle (@user@instance)
|
||
|
|
- **host_lobsters**: lobsters username
|
||
|
|
- **host_matrix**: matrix handle (@user:server)
|
||
|
|
- **host_discord**: discord user id
|
||
|
|
- **host_bluesky**: bluesky handle (handle.bsky.social)
|
||
|
|
- **host_location**: your location
|
||
|
|
- **host_interests**: comma-separated interests
|
||
|
|
- **host_looking_for**: what you're looking for
|
||
|
|
|
||
|
|
### api credentials
|
||
|
|
- **github_token**: for higher rate limits
|
||
|
|
- **groq_api_key**: for LLM-drafted intros
|
||
|
|
- **mastodon_token**: for DM delivery
|
||
|
|
- **discord_bot_token**: for discord discovery/delivery
|
||
|
|
|
||
|
|
## hacs integration
|
||
|
|
|
||
|
|
after starting the add-on, install the connectd integration via HACS:
|
||
|
|
|
||
|
|
1. add custom repository: `https://github.com/sudoxnym/connectd`
|
||
|
|
2. install connectd integration
|
||
|
|
3. add integration in HA settings
|
||
|
|
4. configure with host: `localhost`, port: `8099`
|
||
|
|
|
||
|
|
## sensors
|
||
|
|
|
||
|
|
- total humans, high score humans, active builders
|
||
|
|
- platform counts (github, mastodon, reddit, lemmy, discord, lobsters)
|
||
|
|
- priority matches, top humans
|
||
|
|
- countdown timers (next scout, match, intro)
|
||
|
|
- your personal score and profile
|