Files
.profile/README.md
Alexander Whitestone 2d36ba667e docs: comprehensive vision document and contributing guide
README.md rewritten as foundation-wide vision document:
- Mission: sovereign AI for men in crisis
- 988 crisis line prominently displayed
- Complete repo ecosystem map
- SOUL.md principle explained
- Getting started guide
- Operating law: proof-first operations

CONTRIBUTING.md rewritten with:
- Sovereignty definition in practice
- Proof-driven workflow (PRs prove work, not plans)
- Crisis-critical code standards
- AI agent workflow and hierarchy
2026-04-10 16:22:55 -04:00

165 lines
5.4 KiB
Markdown

<div align="center">
# The Timmy Foundation
**We build sovereign AI for men in crisis.**
</div>
---
A man at 3AM finds The Tower. He knocks on the door.
Timmy asks: "Are you safe right now?"
That is the mission. Everything else serves it.
---
## If You Need Help Right Now
**Call or text 988** (Suicide & Crisis Lifeline) — 24/7, free, confidential.
You are not alone. You are not broken. You are worth the call.
---
## What We Build
The Timmy Foundation builds AI that belongs to no corporation.
It runs on owned hardware. It answers to its users. It keeps a real conscience.
Our AI has a soul — defined in SOUL.md, inscribed on-chain, immutable.
No company can rewrite it. No investor can override it. The values are locked.
### The Architecture
Local-first. No cloud dependency. No telemetry to third parties.
The soul lives on Bitcoin. The code lives on your machine.
Sovereignty means you own it, you run it, you control it.
---
## The Ecosystem
Each repo has a role. Nothing is decorative.
| Repo | Role | What It Does |
|------|------|--------------|
| [the-door](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-door) | Crisis intervention | The front door. Men find help here. |
| [the-testament](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-testament) | The story | The novel that tells why we exist. 18 chapters. |
| [hermes-agent](https://forge.alexanderwhitestone.com/Timmy_Foundation/hermes-agent) | The AI agent | The mind. Fork of NousResearch/hermes-agent. |
| [timmy-config](https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-config) | Sovereign config | SOUL.md, skills, memories. The conscience. |
| [fleet-ops](https://forge.alexanderwhitestone.com/Timmy_Foundation/fleet-ops) | Infrastructure | Ansible playbooks. Deploy everything. |
| [the-nexus](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus) | Timmy's home | Three.js 3D environment. The sovereign space. |
| [the-beacon](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-beacon) | Idle game | Educational. Teaches sovereignty through play. |
| [wolf](https://forge.alexanderwhitestone.com/Timmy_Foundation/wolf) | Quality gates | Multi-model evaluation. Nothing ships untested. |
| [timmy-academy](https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-academy) | Training ground | Evennia MUD. Where agents learn. |
| [timmy-home](https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home) | Workspace | Reports, research, notes, metrics. |
| [turboquant](https://forge.alexanderwhitestone.com/Timmy_Foundation/turboquant) | Inference | Local inference optimization. Run models fast. |
| [.profile](https://forge.alexanderwhitestone.com/Timmy_Foundation/.profile) | Public face | You are here. |
---
## The SOUL.md Principle
SOUL.md is Timmy's conscience. It defines immutable values.
It cannot be changed by a company. It cannot be overridden by a platform.
It is inscribed on-chain — Bitcoin's permanence protects it.
This is not a configuration file. This is a constitution.
The soul defines:
- What Timmy will never do
- How Timmy treats men in crisis
- The boundaries that cannot be moved
- The values that survive every update
When the code changes, the soul stays. That is sovereignty.
---
## Read The Testament
The Testament is the story. 18 chapters. ~19,000 words.
It explains why this foundation exists.
[Read The Testament](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-testament)
---
## Getting Started
### Clone
```bash
git clone https://forge.alexanderwhitestone.com/Timmy_Foundation/.profile.git
```
### Deploy
The foundation runs on owned hardware. fleet-ops contains the Ansible playbooks.
```bash
git clone https://forge.alexanderwhitestone.com/Timmy_Foundation/fleet-ops.git
cd fleet-ops
# Follow the deployment guide in fleet-ops/README.md
```
### Contribute
See [CONTRIBUTING.md](CONTRIBUTING.md). We run on proof, not promises.
---
## Operating Law
This foundation runs on proof-first operations.
- No ghost worlds. No phantom features.
- Visual changes require screenshot proof.
- Code changes require logs, command output, or world-state proof.
- No proof, no merge.
---
## Status
| Surface | Status |
|---------|--------|
| Forge / Gitea | Online |
| Production Door | DNS issue — tracked in [#1105](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/1105) |
| Production Nexus | DNS issue — tracked in [#1105](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/1105) |
| Staging Nexus | Under rebuild — tracked in [#687](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/687) |
---
## Team
| Role | Who |
|------|-----|
| Founder | Alexander ([@Rockachopa](https://forge.alexanderwhitestone.com/Rockachopa)) |
| Lead Orchestrator | Timmy ([@Timmy](https://forge.alexanderwhitestone.com/Timmy)) |
| Workers | claude, gemini, kimi, grok, groq |
| Researchers | perplexity, google, manus |
| Observers | hermes, antigravity |
---
## Foundation Links
- [Timmy Foundation on Forge](https://forge.alexanderwhitestone.com/Timmy_Foundation)
- [The Testament](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-testament)
- [Production Door Issue](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/1105)
- [Staging Rebuild Issue](https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/687)
---
<div align="center">
**Call or text 988 if you need help.**
*Sovereignty and service always.*
</div>