sam/central_ai_llm_master
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Hub runtime: allocate port 8788, add Go skeleton and Docker deployment

Browse Source 
Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Sam Rolfe
2026-10-10 17:11:52 +11:00
parent 26cb4d324d
commit cd56e69a2f
10 changed files with 185 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/hub-api.md
View File

@@ -46,8 +46,7 @@ endpoint with the shape in `docs/ask-contract.md`.
### Base
- Base URL: `http://192.168.20.13:8787` (port 8787 is the proposed default,
`HUB_PORT`). Confirm the port against the house port list before deploy.
- Base URL: `http://192.168.20.13:8788` (the allocated Hub port, `HUB_PORT`; recorded in `docs/outline/02-config-and-env.md`).
- Plain HTTP on the private LAN for v1. Put a TLS reverse proxy in front later.
- Request and response body: JSON, `application/json; charset=utf-8`.
- Maximum request body: 64 KiB. Larger bodies get `413`.

2
docs/outline/00-index.md
View File

@@ -30,7 +30,7 @@ hold a personality or a memory. The Hub does not do the destination work.
- **Env File**: `~/.config/environment.d/10-secrets.conf`
- **Config Directory**: `docs/`
- **Active Ports**: Hub 8787 (`HUB_PORT`, proposed default — confirm before deploy).
- **Active Ports**: Hub 8788 (`HUB_PORT`, allocated 2026-10-10).
## Agent Restart Steps

4
docs/outline/02-config-and-env.md
View File

@@ -33,7 +33,9 @@ Relevant keys:
| Home Assistant | 192.168.20.30 | 8123 | Devices and timers. |
| MQTT | 192.168.20.13 | 1883 | Voice topics. |
| Apprise | 192.168.20.35 | 8210 | Notifications. |
| Hub | 192.168.20.13 | 8787 | This service. Proposed default (`HUB_PORT`). |
| Hub | 192.168.20.13 | 8788 | This service. Allocated 2026-10-10. `HUB_PORT`, default 8788. |
> Port 8787 was only a proposal. It is used by the `headroom` container. Port 8788 was free on 2026-10-10 and is the allocated Hub port.
## Config Paths

10
docs/outline/03-code-map.md
View File

@@ -1,7 +1,7 @@
# Central AI Hub — Code Structure Map
> **Writing Style**: ASD-STE100 Simplified Technical English (`ste-writing`).
> **Status**: Planned. The Hub is not built yet.
> **Status**: Skeleton built (AUD-48). Routing (AUD-49) is not built yet.
## Planned Folder Layout
@@ -10,6 +10,9 @@ central_ai_llm_master/
AGENTS.md project rules for agents
hub_brief.md agreed design (source of truth)
README.md technical readme
Dockerfile multi-stage build (static binary, distroless)
docker-compose.yml one container, port 8788
.dockerignore build context filter
docs/
hub-architecture.mmd Mermaid source
hub-architecture-map.html Archify map
@@ -19,8 +22,9 @@ central_ai_llm_master/
ask-contract.md Hub to project interface
hub-api.md frozen inbound API (v1)
vikunja-tasks.json human task list
src/ Hub service code (to build)
main.go HTTP entry point
src/ Hub service code
go.mod module hub
main.go HTTP entry point (GET /health)
hear/ takes voice or text
understand/ LLM intent routing
check/ authorization and approval