lhumina_code/hero_books
19
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions

operational: deploy hero ecosystem on K8s cluster #15

New issue
Closed
opened 2026-02-07 15:09:13 +00:00 by despiegk · 5 comments
despiegk commented 2026-02-07 15:09:13 +00:00
Owner
Copy link
  • bring live in kubernetes cluster Jan
  • geomind
  • ourworld
  • mycelium

ask Kristof which books are good

can be as current web format (just html based, like now), so we have something live

make sure all other "now" issues resolved

+ bring live in kubernetes cluster Jan - geomind - ourworld - mycelium ask Kristof which books are good can be as current web format (just html based, like now), so we have something live make sure all other "now" issues resolved
despiegk added this to the next milestone 2026-02-07 15:09:13 +00:00
despiegk added this to the ACTIVE project 2026-02-07 15:09:13 +00:00
despiegk removed this from the ACTIVE project 2026-02-07 15:12:43 +00:00
despiegk modified the milestone from next to now 2026-02-07 15:14:50 +00:00
despiegk added this to the ACTIVE project 2026-02-07 15:14:52 +00:00
mik-tf commented 2026-02-10 04:18:31 +00:00
Owner
Copy link

Proof of Concept — Live

A single-VM deployment is live at https://herobooks.gent02.grid.tf, proving the software works end-to-end:

  • All 3 libraries loaded: GeoMind (9 books), Mycelium (21 books), OurWorld (6 books)
  • Semantic search with AI summary
  • MCP endpoint at /mcp (6 tools for AI agents)
  • HTML-based UI (current web format)
  • All other "now" issues resolved (26 closed)

Deployment infra: deploy/single-vm/ (OpenTofu + zinit, no Docker)

Remaining for Production

  • Book curation: Kristof to confirm which books are appropriate for public sharing
  • k3s cluster deployment: Ops to deploy on kubernetes (single-VM is PoC only)

Update: Removed the live single vm for now

## Proof of Concept — Live A single-VM deployment is live at **https://herobooks.gent02.grid.tf**, proving the software works end-to-end: - All 3 libraries loaded: GeoMind (9 books), Mycelium (21 books), OurWorld (6 books) - Semantic search with AI summary - MCP endpoint at `/mcp` (6 tools for AI agents) - HTML-based UI (current web format) - All other "now" issues resolved (26 closed) Deployment infra: `deploy/single-vm/` (OpenTofu + zinit, no Docker) ## Remaining for Production - **Book curation**: Kristof to confirm which books are appropriate for public sharing - **k3s cluster deployment**: Ops to deploy on kubernetes (single-VM is PoC only) --- Update: Removed the live single vm for now
mik-tf commented 2026-02-13 14:50:16 +00:00
Owner
Copy link

@despiegk can you confirm which books you want live on the cluster? Then we can bring it live. Thanks.

@despiegk can you confirm which books you want live on the cluster? Then we can bring it live. Thanks.
mik-tf commented 2026-02-24 12:23:50 +00:00
Owner
Copy link

Kristof, do we bring it live? Can you confirm which books you want? Should be straightforward afterwards. We can sync with ops to bring an instance live.

We can even do

  • Private instance with password for internal docs
  • Public instance without password
Kristof, do we bring it live? Can you confirm which books you want? Should be straightforward afterwards. We can sync with ops to bring an instance live. We can even do - Private instance with password for internal docs - Public instance without password
mik-tf changed title from operational to operational: deploy hero ecosystem on K8s cluster 2026-02-26 03:36:49 +00:00
mik-tf commented 2026-02-26 03:36:50 +00:00
Owner
Copy link

Status update

CI is now green on PR #64 — hero_books builds and passes all tests (fmt, clippy, unit tests, smoke tests).

What needs to deploy on the K8s cluster

The full hero ecosystem, not just hero_books alone:

  1. hero_services (formerly hero_zero) — orchestrator that manages 12+ hero services via zinit. Produces a fat Docker image with all services. hero_books is one of its managed services.
  2. hero_archipelagos — pure WASM frontend (Dioxus 0.7). Produces static WASM/JS/HTML files. Needs a web server (nginx or hero_books itself) to serve the assets. The books island UI lives here.
  3. hero_embedder — vector search service (runs alongside hero_books for semantic search features).

Blocking items

Ready

  • hero_books CI: passing (PR #64)
  • hero_services: active development by Timur, Docker image builds
  • hero_books libraries: geomind, ourworld, mycelium all present in examples/ebooks_local
## Status update **CI is now green** on PR #64 — hero_books builds and passes all tests (fmt, clippy, unit tests, smoke tests). ### What needs to deploy on the K8s cluster The full hero ecosystem, not just hero_books alone: 1. **hero_services** (formerly hero_zero) — orchestrator that manages 12+ hero services via zinit. Produces a fat Docker image with all services. hero_books is one of its managed services. 2. **hero_archipelagos** — pure WASM frontend (Dioxus 0.7). Produces static WASM/JS/HTML files. Needs a web server (nginx or hero_books itself) to serve the assets. The books island UI lives here. 3. **hero_embedder** — vector search service (runs alongside hero_books for semantic search features). ### Blocking items - K8s cluster from Jan - Kubernetes manifests / Helm charts (none exist yet on Forge) - hero_archipelagos wiring: https://forge.ourworld.tf/lhumina_code/hero_archipelagos/issues/13 ### Ready - hero_books CI: passing (PR #64) - hero_services: active development by Timur, Docker image builds - hero_books libraries: geomind, ourworld, mycelium all present in examples/ebooks_local
mik-tf commented 2026-02-26 03:41:57 +00:00
Owner
Copy link

Moved to hero_services

hero_books doesn't deploy independently — it runs as one of 12+ services inside the hero_services Docker image, managed by zinit via hero_zero run.

The deployment/operational concern belongs at the orchestrator level:

→ lhumina_code/hero_services#24 — Deploy hero_services on Jan's K8s cluster

That issue covers K8s manifests, persistent volumes, ingress, CI/CD image publishing, and the priority libraries (geomind, ourworld, mycelium).

hero_books status

All hero_books issues are now resolved:

  • CI is green (PR #64)
  • Native WASM UI moved to hero_archipelagos
  • Deployment tracked at hero_services level

Closing.

## Moved to hero_services hero_books doesn't deploy independently — it runs as one of 12+ services inside the hero_services Docker image, managed by zinit via `hero_zero run`. The deployment/operational concern belongs at the orchestrator level: **→ https://forge.ourworld.tf/lhumina_code/hero_services/issues/24** — Deploy hero_services on Jan's K8s cluster That issue covers K8s manifests, persistent volumes, ingress, CI/CD image publishing, and the priority libraries (geomind, ourworld, mycelium). ### hero_books status All hero_books issues are now resolved: - CI is green (PR #64) - Native WASM UI moved to hero_archipelagos - Deployment tracked at hero_services level Closing.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
development
development_mik
development_kristof
main
v0.1.5
v0.1.4
v0.1.3
v0.1.2
v0.1.1
v0.1.0
v0.0.1-rc1
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
now
Projects
Clear projects
No items
No project
ACTIVE
Assignees
Clear assignees
No assignees
mik-tf
2 participants
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/hero_books#15
No description provided.