docs: refresh org profile portal deck (#1)
This commit was merged in pull request #1.
This commit is contained in:
145
README.md
145
README.md
@@ -4,58 +4,101 @@
|
|||||||
|
|
||||||
**Sovereign AI — Local-First, Inscribed On-Chain**
|
**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.*
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## The Mission
|
## The Mission
|
||||||
|
|
||||||
Caring for broken men in pain. Everything here serves that.
|
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
|
||||||
|
|
||||||
|
[](http://143.198.27.163/)
|
||||||
|
[](http://143.198.27.163:3000/)
|
||||||
|
|
||||||
|
### Local / Sidecar / In Progress
|
||||||
|
|
||||||
|
[](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/issues/687)
|
||||||
|
[](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 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
|
||||||
|
|
||||||
```
|
Not the authority for:
|
||||||
THE NEXUS (Three.js)
|
- Timmy's conscience
|
||||||
Timmy's sovereign home
|
- training center
|
||||||
│
|
- durable telemetry truth
|
||||||
┌──────────────┼──────────────┐
|
|
||||||
│ │ │
|
|
||||||
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
|
|
||||||
```
|
|
||||||
|
|
||||||
## Repos
|
## Canonical Repos
|
||||||
|
|
||||||
| Repo | Purpose | Status |
|
| Repo | Purpose | Current Role |
|
||||||
|------|---------|--------|
|
|------|---------|--------------|
|
||||||
| [the-nexus](the-nexus) | Timmy's 3D home — Three.js world | Active |
|
| [the-nexus](http://143.198.27.163:3000/Timmy_Foundation/the-nexus) | Canonical 3D/home-world repo | Active, under truthful rebuild |
|
||||||
| [sovereign-orchestration](sovereign-orchestration) | Agent workforce brain — SQLite + Python | Active |
|
| [timmy-config](http://143.198.27.163:3000/Timmy_Foundation/timmy-config) | Soul/config/sidecar authority | Active |
|
||||||
| [autolora](autolora) | MLX fine-tuning pipeline, timmy:v0.1-q4 | Active |
|
| [timmy-home](http://143.198.27.163:3000/Timmy_Foundation/timmy-home) | Workspace, reports, training ground | Active |
|
||||||
| [timmy-config](timmy-config) | Soul, config, deploy overlay | Active |
|
| [.profile](http://143.198.27.163:3000/Timmy_Foundation/.profile) | Org profile / landing page | Active |
|
||||||
|
|
||||||
## The Team
|
## The Team
|
||||||
|
|
||||||
@@ -63,15 +106,33 @@ The Timmy Foundation builds sovereign AI infrastructure — systems that run on
|
|||||||
|------|-----|--------|
|
|------|-----|--------|
|
||||||
| **Founder** | Alexander (@rockachopa) | Owner |
|
| **Founder** | Alexander (@rockachopa) | Owner |
|
||||||
| **Lead Orchestrator** | Timmy | Owner |
|
| **Lead Orchestrator** | Timmy | Owner |
|
||||||
| **Workers** | claude, gemini, kimi, groq, grok | Write — push branches, create PRs |
|
| **Workers** | claude, gemini, kimi, grok, groq | Write — branches, PRs, bounded implementation |
|
||||||
| **Researchers** | perplexity, google, manus | Write — reports and findings |
|
| **Researchers** | perplexity, google, manus | Research, reports, briefings |
|
||||||
| **Observers** | antigravity, hermes | Read-only |
|
| **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.*
|
*Sovereignty and service always.*
|
||||||
|
|
||||||
**[alexanderwhitestone.com](https://alexanderwhitestone.com)**
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
20
tests/test_profile_readme.py
Normal file
20
tests/test_profile_readme.py
Normal file
@@ -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
|
||||||
Reference in New Issue
Block a user