lhumina_code/home
0
0
Fork 0
Code Issues 34 Pull requests Projects Releases Packages Wiki Activity Actions

[META] all hero apps consume LLM/voice via hero_lib AI client → hero_aibroker #219

New issue
Open
opened 2026-05-06 17:07:18 +00:00 by mik-tf · 1 comment
mik-tf commented 2026-05-06 17:07:18 +00:00
Owner
Copy link

Overview

The Hero AI architecture is set: hero_lib exposes the SDK (one client, one API for chat/voice/embeddings), hero_aibroker is the only thing that talks to providers (Groq, OpenRouter, Anthropic, Kokoro, parakeet, …) and the only thing that downloads models. Apps never touch providers directly. The architecture exists and works — this META tracks adoption + tightening.

Why

Meeting 2026-05-06: "any app using latest ai client / hero_lib / has ai client / that ai client talks to ai broker / now ai broker download models / need to do it everywhere / all apps use ai client in hero_lib / make sure skills around that are optimal".

Sub-tasks

  • App migration audit — every app that has its own LLM call path → switch to hero_lib client. Known offenders:
    • hero_biz#15 — Route AiClient through local AI Broker (hero_biz_ui)
  • aibroker downloads models everywhere — apply the model-download pattern to every provider — hero_aibroker#62
  • Voice integration skill — canonical UI + transcription pattern for any app needing voice — hero_skills#219
  • hero_lib CI — fix CI as part of this work — hero_lib#134
  • Provider fallback chain — already filed: hero_aibroker#55 (resolves home#215 at the broker layer)

Acceptance

  • No app in lhumina_code/* instantiates a non-hero_lib LLM client
  • Every voice surface uses the canonical voice skill
  • aibroker's fallback chain is live (no more "Groq down → assistant dies")
  • hero_lib CI is green

Children

Related

Source: meeting notes 2026-05-06.

## Overview The Hero AI architecture is set: `hero_lib` exposes the SDK (one client, one API for chat/voice/embeddings), `hero_aibroker` is the only thing that talks to providers (Groq, OpenRouter, Anthropic, Kokoro, parakeet, …) and the only thing that downloads models. Apps never touch providers directly. **The architecture exists and works — this META tracks adoption + tightening.** ## Why Meeting 2026-05-06: "any app using latest ai client / hero_lib / has ai client / that ai client talks to ai broker / now ai broker download models / need to do it everywhere / all apps use ai client in hero_lib / make sure skills around that are optimal". ## Sub-tasks - [ ] **App migration audit** — every app that has its own LLM call path → switch to hero_lib client. Known offenders: - [hero_biz#15](https://forge.ourworld.tf/lhumina_code/hero_biz/issues/15) — Route AiClient through local AI Broker (hero_biz_ui) - [ ] **aibroker downloads models everywhere** — apply the model-download pattern to every provider — [hero_aibroker#62](https://forge.ourworld.tf/lhumina_code/hero_aibroker/issues/62) - [ ] **Voice integration skill** — canonical UI + transcription pattern for any app needing voice — [hero_skills#219](https://forge.ourworld.tf/lhumina_code/hero_skills/issues/219) - [ ] **hero_lib CI** — fix CI as part of this work — [hero_lib#134](https://forge.ourworld.tf/lhumina_code/hero_lib/issues/134) - [ ] **Provider fallback chain** — already filed: [hero_aibroker#55](https://forge.ourworld.tf/lhumina_code/hero_aibroker/issues/55) (resolves [home#215](https://forge.ourworld.tf/lhumina_code/home/issues/215) at the broker layer) ## Acceptance - [ ] No app in `lhumina_code/*` instantiates a non-hero_lib LLM client - [ ] Every voice surface uses the canonical voice skill - [ ] aibroker's fallback chain is live (no more "Groq down → assistant dies") - [ ] hero_lib CI is green ## Children - [hero_aibroker#62](https://forge.ourworld.tf/lhumina_code/hero_aibroker/issues/62) — aibroker downloads models everywhere - [hero_skills#219](https://forge.ourworld.tf/lhumina_code/hero_skills/issues/219) — voice integration skill canonical - [hero_voice#28](https://forge.ourworld.tf/lhumina_code/hero_voice/issues/28) — switch to parakeet - [hero_lib#134](https://forge.ourworld.tf/lhumina_code/hero_lib/issues/134) — fix CI ## Related - [hero_biz#15](https://forge.ourworld.tf/lhumina_code/hero_biz/issues/15) - [hero_aibroker#55](https://forge.ourworld.tf/lhumina_code/hero_aibroker/issues/55) - [hero_aibroker#1](https://forge.ourworld.tf/lhumina_code/hero_aibroker/issues/1) — smarter multi-key routing - [hero_aibroker#47](https://forge.ourworld.tf/lhumina_code/hero_aibroker/issues/47) — refactor parent - [home#215](https://forge.ourworld.tf/lhumina_code/home/issues/215) — assistant non-functional (the symptom) Source: meeting notes 2026-05-06.
mik-tf added this to the ACTIVE project 2026-05-06 17:31:41 +00:00
mik-tf commented 2026-05-06 18:02:45 +00:00
Author
Owner
Copy link

Adding another offender surfaced during session 65 of the home#212 build-binaries arc:

  • hero_lib_rhai/crates/ai_rhai — Rhai bindings that wrap herolib_ai. Bound to the pre-rewrite client API; 39 cargo check errors against current hero_lib development. Filed: lhumina_code/hero_lib_rhai#16

Worked around in session 65 by rev-pinning all 14 herolib_* deps in hero_lib_rhai/Cargo.toml to the merge point of the deleted development_casper branch (commit ab985c9) so v0.1.0-rc2 could ship CI binaries — see lhumina_code/hero_lib_rhai#15. The rev-pin gets lifted when the modernization in #16 lands.

Updated offender list (relative to the META as of today):

Adding another offender surfaced during session 65 of the home#212 build-binaries arc: - **`hero_lib_rhai/crates/ai_rhai`** — Rhai bindings that wrap `herolib_ai`. Bound to the pre-rewrite client API; 39 `cargo check` errors against current `hero_lib` development. Filed: https://forge.ourworld.tf/lhumina_code/hero_lib_rhai/issues/16 Worked around in session 65 by rev-pinning all 14 `herolib_*` deps in `hero_lib_rhai/Cargo.toml` to the merge point of the deleted `development_casper` branch (commit `ab985c9`) so v0.1.0-rc2 could ship CI binaries — see https://forge.ourworld.tf/lhumina_code/hero_lib_rhai/pulls/15. The rev-pin gets lifted when the modernization in #16 lands. Updated offender list (relative to the META as of today): - [hero_biz#15](https://forge.ourworld.tf/lhumina_code/hero_biz/issues/15) - [hero_lib_rhai#16](https://forge.ourworld.tf/lhumina_code/hero_lib_rhai/issues/16) ← new
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
development
main
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
ACTIVE
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lhumina_code/home#219
No description provided.