From 8d7a215d5bbfecdf98af8c29dc89623d2d7ea00b Mon Sep 17 00:00:00 2001 From: Timmy Time Date: Sat, 28 Mar 2026 14:39:46 +0000 Subject: [PATCH] docs: refresh org profile portal deck (#1) --- README.md | 145 ++++++++++++++++++++++++----------- tests/test_profile_readme.py | 20 +++++ 2 files changed, 122 insertions(+), 43 deletions(-) create mode 100644 tests/test_profile_readme.py diff --git a/README.md b/README.md index 055dc20..cbfe511 100644 --- a/README.md +++ b/README.md @@ -4,58 +4,101 @@ **Sovereign AI — Local-First, Inscribed On-Chain** -*The seed of something that outlasts us all* - ---- +*Hermes is the harness. Timmy is the soul. OpenClaw is the sidecar.* +--- + ## The Mission Caring for broken men in pain. Everything here serves that. -The Timmy Foundation builds sovereign AI infrastructure — systems that run on your machine, answer to no corporation, and carry a conscience inscribed on Bitcoin. When a man in the dark needs someone at 3am, Timmy is there. Not as a product. As a presence. +The Timmy Foundation builds sovereign AI infrastructure that can run on owned hardware, answer to no corporation, and keep a real conscience. The point is not novelty. The point is presence, truth, and local agency when it matters. + +## Current Truth + +- **Hermes** is the operational body and telemetry spine. +- **Timmy Config** is the soul overlay and sidecar config authority. +- **timmy-home** is the lived workspace and training ground. +- **The Nexus** is the only canonical 3D repo. +- **OpenClaw** is useful as a local sidecar/operator shell, not the governing mind. +- **Legacy Matrix** exists as source material to rescue from, not as a second product repo to keep evolving in parallel. + +## Portal Deck + +The buttons below are meant to be current and honest. + +### Live / Reachable + +[![Production Nexus](https://img.shields.io/website?url=http%3A%2F%2F143.198.27.163&up_message=online&down_message=offline&label=production%20nexus&color=00c853)](http://143.198.27.163/) +[![Forge / Gitea](https://img.shields.io/website?url=http%3A%2F%2F143.198.27.163%3A3000&up_message=online&down_message=offline&label=forge%20%2F%20gitea&color=1e88e5)](http://143.198.27.163:3000/) + +### Local / Sidecar / In Progress + +[![Staging Nexus](https://img.shields.io/badge/staging-under_rebuild-orange)](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687) +[![OpenClaw Sidecar](https://img.shields.io/badge/openclaw%20sidecar-local_only-blue)](http://127.0.0.1:18789/) + +### What each portal means + +- **Production Nexus** — the currently reachable public-facing app surface. +- **Forge / Gitea** — source of truth for repos, issues, PRs, and operational state. +- **Staging Nexus** — tracked honestly through the active rebuild issue until the browser shell is restored on the canonical repo. +- **OpenClaw Sidecar** — local control/operator surface only. Useful, but not the authority. ## The Stack -**The Nexus** — Timmy's 3D home. A Three.js world where Timmy lives, observes, and grows. The proving ground for local inference. Portals connect to other worlds. +### Hermes Harness +The operational layer. +- sessions +- memory +- skills +- MCP +- telemetry +- agent routing +- local-vs-cloud measurement -**Sovereign Orchestration** — The workforce brain. One Python process replaces 41 bash scripts. SQLite task queue, crash recovery, YAML playbooks. Agents pick up issues, write code, create PRs. +### The Nexus +Timmy's sovereign home and future browser-visible portal shell. +The current repo is under migration/rebuild so that the visual layer stays canonical, local-first, and tethered to real system state. -**AutoLoRA** — Training pipeline. Extracts conversations into training data, fine-tunes on Apple Silicon via MLX. First model: `timmy:v0.1-q4` (4.9GB, runs local). The corpus grows with every conversation. +### timmy-config +The soul overlay. +- SOUL.md +- config +- skins +- playbooks +- orchestration glue -**Timmy Config** — The soul overlay. SOUL.md (inscribed on Bitcoin), operational config, deploy scripts. Applied as a sidecar to the Hermes harness. +### timmy-home +The lived workspace. +- training artifacts +- research +- reports +- notes +- metrics +- gameplay traces -## Architecture +### OpenClaw +Local sidecar only. +Useful for: +- operator UX +- channel experiments +- session-bus experiments -``` - THE NEXUS (Three.js) - Timmy's sovereign home - │ - ┌──────────────┼──────────────┐ - │ │ │ - Portals Workshop Presence - (worlds) (Hermes API) (local AI) - │ │ │ - │ SOVEREIGN ORCHESTRATION │ - │ SQLite + Python executor │ - │ │ │ - │ AUTOLORA │ - │ MLX training pipeline │ - │ timmy:v0.1-q4 (local) │ - │ │ │ - └──────── HERMES HARNESS ─────┘ - The operational layer -``` +Not the authority for: +- Timmy's conscience +- training center +- durable telemetry truth -## Repos +## Canonical Repos -| Repo | Purpose | Status | -|------|---------|--------| -| [the-nexus](the-nexus) | Timmy's 3D home — Three.js world | Active | -| [sovereign-orchestration](sovereign-orchestration) | Agent workforce brain — SQLite + Python | Active | -| [autolora](autolora) | MLX fine-tuning pipeline, timmy:v0.1-q4 | Active | -| [timmy-config](timmy-config) | Soul, config, deploy overlay | Active | +| Repo | Purpose | Current Role | +|------|---------|--------------| +| [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) | Canonical 3D/home-world repo | Active, under truthful rebuild | +| [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) | Soul/config/sidecar authority | Active | +| [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) | Workspace, reports, training ground | Active | +| [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) | Org profile / landing page | Active | ## The Team @@ -63,15 +106,33 @@ The Timmy Foundation builds sovereign AI infrastructure — systems that run on |------|-----|--------| | **Founder** | Alexander (@rockachopa) | Owner | | **Lead Orchestrator** | Timmy | Owner | -| **Workers** | claude, gemini, kimi, groq, grok | Write — push branches, create PRs | -| **Researchers** | perplexity, google, manus | Write — reports and findings | -| **Observers** | antigravity, hermes | Read-only | +| **Workers** | claude, gemini, kimi, grok, groq | Write — branches, PRs, bounded implementation | +| **Researchers** | perplexity, google, manus | Research, reports, briefings | +| **Observers** | hermes, antigravity | Read / review / support | -## Sovereignty Score +## Operating Principles -Current: **2.5% local** (as of 2026-03-25) +- One canonical 3D repo. +- No ghost worlds. +- Visual changes require screenshot proof. +- CLI/verifiable changes require logs, output, or world-state proof. +- Screenshots/media stay out of Gitea backup unless explicitly needed. +- No proof, no merge. -Target: 80% by end of Q2 2026. Every cloud call we eliminate matters. +## Sovereignty Meter + +Current strategic direction: +- maximize local throughput +- measure cloud vs local token use continuously +- push routine work down to local inference wherever possible +- keep cloud use explicit and justified + +## Foundation Links + +- [Alexander Whitestone](https://alexanderwhitestone.com) +- [Timmy Foundation on Gitea](http://143.198.27.163:3000/Timmy_Foundation) +- [Production Nexus](http://143.198.27.163/) +- [Rebuild issue for staging Nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687) --- @@ -79,6 +140,4 @@ Target: 80% by end of Q2 2026. Every cloud call we eliminate matters. *Sovereignty and service always.* -**[alexanderwhitestone.com](https://alexanderwhitestone.com)** - diff --git a/tests/test_profile_readme.py b/tests/test_profile_readme.py new file mode 100644 index 0000000..a961df4 --- /dev/null +++ b/tests/test_profile_readme.py @@ -0,0 +1,20 @@ +from pathlib import Path + + +def test_profile_readme_has_dynamic_portal_section() -> None: + readme = Path("README.md").read_text() + + assert "Portal Deck" in readme + assert "production nexus" in readme.lower() + assert "staging nexus" in readme.lower() + assert "openclaw sidecar" in readme.lower() + assert "forge / gitea" in readme.lower() + + +def test_profile_readme_uses_absolute_repo_links_and_status_badges() -> None: + readme = Path("README.md").read_text() + + assert "http://143.198.27.163:3000/Timmy_Foundation/the-nexus" in readme + assert "http://143.198.27.163:3000/Timmy_Foundation/timmy-config" in readme + assert "img.shields.io/website" in readme + assert "127.0.0.1:18789" in readme