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
165 lines
5.4 KiB
Markdown
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>
|