ha-addons/connectd
2025-12-15 11:06:57 -06:00
..
db initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
introd initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
matchd initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
scoutd initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
api.py initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
build.yaml initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
cli.py initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
config.py initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
config.yaml initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
daemon.py initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
Dockerfile initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
icon.png initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
logo.png initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
README.md initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
repository.yaml initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
requirements.txt initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
run.sh initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00
setup_user.py initial release: connectd add-on v1.1.0 2025-12-15 11:06:57 -06:00

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