# TRC (trc.inc) — Complete Technical Documentation, Infrastructure Economics & Platform Reference

> Official Website: https://www.trc.inc
> Canonical Documentation Hub: https://www.trc.inc/docs
> Concise AI Directory: https://www.trc.inc/llms.txt
> OpenAPI 3.1 Specification: https://www.trc.inc/openapi.json
> Production REST API Base URL: https://api.trc.inc/api/v1
> Legal Operating Entity: Relationship Constitution, LLC (Grand Rapids, Michigan, USA)
> Entity Disambiguation: TRC (trc.inc) is an independent sovereign cloud, AI model gateway, multi-platform workstation, creative studio, and human alignment platform. It is NOT affiliated with TRC Companies, Inc. (trccompanies.com), trcinc.net, or corporate business incorporation services.

## Table of Contents
1. [TRC Documentation — Cloud, Sovereign Enclaves, Unified API & Client Platforms](https://www.trc.inc/docs)
2. [TRC Live Price, Latency & Specification Proof — Verify Every Claim in 30 Seconds](https://www.trc.inc/docs/proof)
3. [TRC Sovereign Cloud — Dedicated AMD EPYC Enclaves & Push-to-Deploy PaaS](https://www.trc.inc/docs/cloud)
4. [TRC Cloud Storage Vault — Web Drive & Programmatic S3/B2 Object API](https://www.trc.inc/docs/storage)
5. [TRC Developer API v1 — Unified AI Model Gateway, Media, Voice & Storage Reference](https://www.trc.inc/docs/api)
6. [TRC Singularity — Capabilities, Local Privacy & Operator Permission Architecture](https://www.trc.inc/docs/singularity)
7. [TRC Web Platform Guide — AI Workstations, Creative Studios, Office, 3D & Zero-Fee Commerce](https://www.trc.inc/docs/web)
8. [TRC Mobile Documentation — Android & iOS App, PC Bridge, LiveKit Calls & Lossless Music](https://www.trc.inc/docs/mobile)
9. [TRC Singularity Desktop Documentation — macOS (Apple Silicon & Intel), Windows & Native Suite](https://www.trc.inc/docs/desktop)
10. [TRC VS Code Extension — Copilot Chat Model Provider, 36 Tools, MCP Bridges & Team Bus](https://www.trc.inc/docs/vscode)
11. [TRC Migration Guides — Switch Your Cloud, DB, AI APIs & Storage in Under 5 Minutes](https://www.trc.inc/docs/migrate)

---
# TRC Documentation — Cloud, Sovereign Enclaves, Unified API & Client Platforms

> Canonical URL: https://www.trc.inc/docs
> Category: Start & Economics (Unified Documentation)

Everything your team or company needs to replace fragmented cloud hosting, storage buckets, AI model subscriptions, creative SaaS, and developer tooling with one sovereign platform, one wallet, and one API.

## Key Specifications
- **Free Cloud Vault**: 50 GB Included — Expandable to 50 TB via Web & /api/v1/storage
- **Cloud Enclaves**: From $5/mo — Dedicated AMD EPYC + Postgres 16 + Redis 7
- **AI Model Gateway**: $0 BYOK Markup — 50% automatic off-peak DeepSeek + cache hits
- **Partner Commerce Fee**: 0% on Pro — Keep 100% of bookings & store revenue ($99/mo)

## What TRC Gives You — And Why Teams Switch Infrastructure

Modern businesses and independent builders routinely pay six to ten separate vendors just to ship and operate software: frontend hosting, managed Postgres, managed Redis, S3 object storage, multiple LLM API providers, desktop/IDE coding subscriptions, video/audio production tools, office suites, and high-commission creator marketplaces.

TRC (https://www.trc.inc) consolidates that entire stack into one cohesive operating system backed by a single deterministic wallet, scoped SHA-256 API keys, hardware-isolated Sovereign Cloud enclaves, and native applications across Web, Mobile (Android & iOS), Desktop (macOS Apple Silicon, macOS Intel, Windows 10/11), and Visual Studio Code.

### Monthly Total Cost of Ownership (TCO): Fragmented SaaS Stack vs. TRC Unified Stack
| Capability Layer | Typical Fragmented Vendor Stack | Fragmented Cost | TRC Unified Equivalent |
| --- | --- | --- | --- |
| Full-Stack App + DB + Redis Hosting | Vercel Pro + Managed Postgres + Redis + TLS | $65 – $140/mo | Included in Sovereign Cloud Commercial Pro ($20/mo dedicated AMD EPYC, Postgres 16 + pgvector, Redis 7) |
| Object Storage & Dataset Vault (2 TB – 5 TB) | AWS S3 / Cloud Object Storage + Egress Fees | $46 – $115/mo + egress | 50 GB Free ($0/mo) · 2 TB on Basic ($15/mo) · 5 TB on Pro ($50/mo) · 10 TB on Ultimate ($200/mo) |
| Multi-Model AI Gateway & Voice Inference | Separate OpenAI, Anthropic, Google & Realtime Voice accounts | $60 – $200+/mo | Single /api/v1 gateway · $0 BYOK markup · DeepSeek V4.1 from $0.15/1M in · Qwen 3.5 Omni Realtime $0.10/1M |
| Autonomous Desktop Agent + VS Code Provider | Per-seat AI IDE + Copilot add-ons | $20 – $60/seat/mo | TRC Singularity Desktop + VS Code Extension included (Wallet, $0 BYOK, or $0 local Ollama GPU) |
| Creative Studios, Office Suite & Lossless Music | Video clipper + Social scheduler + Office + Music streaming | $55 – $120/mo | Video/Image/Audio/Post Studios + TRC Office (Word/Sheets/Slides) + 100% Free Lossless Music & DJ Mode |
| Advisor Bookings, Courses & Storefront Fees | 5% – 20% marketplace platform cut | $150 – $600/mo at $3k GMV | 0% TRC platform fee on Partner Pro ($99/mo) — keep 100%, pay only standard Stripe 2.9% |

## 60-Second Developer Quickstart

Every TRC account can mint scoped developer keys from the API Console (/developer/api) and immediately call the OpenAI-compatible AI Gateway or stream files up to 2 GB into your Cloud Storage Vault.

Point any existing OpenAI SDK client at https://api.trc.inc/api/v1/ai/deepseek (or google, openai, anthropic, alibaba, kimi, xai, together) with your trc_... key — zero application code rewrite required. Want to test live inference and verify token math in 10 seconds before creating an account? Open Live Price & Spec Proof (/docs/proof) or pass our capped zero-card evaluator key Bearer trc_eval_public_v1 on deepseek-flash.

### Example: cURL
```bash
# 1. Call the OpenAI-compatible TRC AI Gateway
curl -X POST "https://api.trc.inc/api/v1/ai/deepseek/chat/completions" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      { "role": "system", "content": "Summarize infrastructure migration steps concisely." },
      { "role": "user", "content": "We are moving a Node API, Postgres pgvector DB, and 1.5 TB of media to TRC." }
    ],
    "temperature": 0.2
  }'

# 2. Stream a binary dataset or build artifact straight to your Cloud Storage Vault
curl -X POST "https://api.trc.inc/api/v1/storage/upload?folder=datasets/prod" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -H "Content-Type: application/octet-stream" \
  -H "x-file-name: embeddings-snapshot-v1.parquet" \
  --data-binary "@./embeddings-snapshot-v1.parquet"
```

### Example: TypeScript (OpenAI SDK)
```typescript
import OpenAI from 'openai';

// Drop-in OpenAI SDK client — switch providers by changing one path segment:
// /ai/deepseek | /ai/google | /ai/openai | /ai/anthropic | /ai/alibaba | /ai/kimi | /ai/xai
const trc = new OpenAI({
  apiKey: process.env.TRC_API_KEY, // Bearer trc_... (models:use scope)
  baseURL: 'https://api.trc.inc/api/v1/ai/deepseek',
});

const completion = await trc.chat.completions.create({
  model: 'deepseek-flash',
  messages: [
    { role: 'user', content: 'Generate a PostgreSQL 16 pgvector index migration for 1536-d embeddings.' },
  ],
});

console.log(completion.choices[0]?.message?.content);
```

### Example: Python (AI + Vault)
```python
import os
import requests
from openai import OpenAI

API_KEY = os.environ["TRC_API_KEY"]

# 1. Frontier reasoning via standard OpenAI Python client
client = OpenAI(
    api_key=API_KEY,
    base_url="https://api.trc.inc/api/v1/ai/google",
)
resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "List three health-check probes for zero-downtime deploys."}],
)
print(resp.choices[0].message.content)

# 2. Check your 50 GB - 50 TB Cloud Storage Vault quota & upload a checkpoint
usage = requests.get(
    "https://api.trc.inc/api/v1/storage/usage",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=30,
).json()
print("Vault usage:", usage)

with open("model-weights.safetensors", "rb") as fh:
    up = requests.post(
        "https://api.trc.inc/api/v1/storage/upload",
        params={"folder": "checkpoints"},
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/octet-stream",
            "x-file-name": "model-weights.safetensors",
        },
        data=fh,
        timeout=300,
    )
    print("Uploaded:", up.json())
```

## Complete Documentation Directory

Select any chapter below or from the left navigation rail to dive into architecture specs, CLI/SDK commands, security boundaries, and client setup guides.

- **[Live Price, Latency & Spec Proof](https://www.trc.inc/docs/proof)** (Zero-Card Evaluator Key · GET /api/v1/pricing · Automated Receipt): Verify every TRC model rate, Sovereign Cloud enclave tier, and SHA-256 release hash live in under 30 seconds — no signup or credit card required.
- **[Migration & Switching Guides](https://www.trc.inc/docs/migrate)** (5-Minute Runbooks · pg_restore · 1-Line SDK Swap · Zero Vault Egress): Step-by-step commands to replace Vercel, Supabase, Render, AWS S3, and fragmented AI accounts with one sovereign TRC stack.
- **[Sovereign Cloud & Dedicated Enclaves](https://www.trc.inc/docs/cloud)** ($5 – $149/mo · AMD EPYC · Nixpacks · pgvector · HTTP/3): Deploy GitHub repositories onto isolated dedicated enclaves with auto-wired Postgres 16, Redis 7, AES-256-GCM vaults, and Two-Tree Survivor recovery.
- **[Cloud Storage Vault (50 GB – 50 TB)](https://www.trc.inc/docs/storage)** (S3 / B2 Backed · 2 GB Streaming Uploads · Signed URLs): Use your subscription storage quota as both an interactive web drive and a programmatic REST object store for datasets, backups, and media.
- **[REST API v1 & Model Gateway](https://www.trc.inc/docs/api)** (12 Scopes · OpenAI & Anthropic Compatible · OpenAPI 3.1): Full endpoint reference, live token & off-peak cache pricing, Whisper transcription, chroma-key game tilesets, music generation, and telephony.
- **[TRC Singularity Architecture](https://www.trc.inc/docs/singularity)** (127.0.0.1 Local Sovereignty · Permission Gates · Checkpoints): Understand how TRC Singularity unifies coding, studios, office documents, and cloud operations under strict operator permission controls.
- **[Web Platform (www.trc.inc)](https://www.trc.inc/docs/web)** (MultiChat+ · 6 Studios · TRC Office · 0% Fee Partner Pro): Run AI workstations, Video/Image/Audio/Post Studios, TRC Meet, MonoVox 3D worlds, Living Constitutions, and zero-commission storefronts in any browser.
- **[Mobile Devices (Android & iOS)](https://www.trc.inc/docs/mobile)** (Android APK v1.1.6 · PC Bridge · LiveKit · Lossless Music): Voice-first Singularity on the go, remote PC Bridge control, LiveKit calls with live translation, free lossless music, and direct Android APK setup.
- **[Desktop App (macOS & Windows)](https://www.trc.inc/docs/desktop)** (Singularity v1.4.318 · Apple Silicon · Intel · Win x64): Native installers, local daemon startup, macOS Gatekeeper & TCC permissions, TRC Paint v6.0, TRC Office .oxt, and offline Ollama GPU mode.
- **[VS Code Extension](https://www.trc.inc/docs/vscode)** (VSIX v1.13.6 · Copilot Chat Provider · 36 Native Tools): Plug TRC models, BYOK keys, inline sprite-sheet generation, MCP servers, Multi-Agent Team Bus, and lossless music straight into VS Code.

## Frequently Asked Questions

### Can I evaluate TRC without entering a credit card?
Yes. The Free plan ($0/mo) includes 50 GB of Cloud Storage Vault capacity (accessible on the web and via /api/v1/storage), Frontier Flash AI models, MultiChat, and 100% free unlimited lossless music streaming.

### Where can AI agents and automated tools fetch machine-readable TRC specs?
Fetch https://www.trc.inc/llms.txt for the concise directory, https://www.trc.inc/llms-full.txt for the complete single-file Markdown technical reference, https://api.trc.inc/api/v1/pricing for the live unauthenticated rate card, and https://www.trc.inc/openapi.json for the OpenAPI 3.1 REST specification.


---

# TRC Live Price, Latency & Specification Proof — Verify Every Claim in 30 Seconds

> Canonical URL: https://www.trc.inc/docs/proof
> Category: Start & Economics (Zero-Card Live Verification)

Do not take static marketing pages on faith. Query TRC’s live unauthenticated pricing feed, execute a real DeepSeek V4.1 Flash completion with our capped zero-card evaluator key, and verify exact micro-dollar billing math and SHA-256 release hashes yourself.

## Key Specifications
- **Public Pricing Feed**: GET /api/v1/pricing — Unauthenticated JSON derived directly from live billing code
- **Zero-Card Evaluator**: trc_eval_public_v1 — Live deepseek-flash inference + micro-dollar receipt headers
- **DeepSeek Off-Peak**: $0.15 / 1M in — Active 79% of week (133/168 hrs) · $0.003/1M cached
- **Fee Transparency**: 0% BYOK · 10% Wallet — $0.00 BYOK surcharge · 10% managed TRC Wallet gateway fee

## Every Headline Claim & How to Verify It Yourself

Engineers, CTOs, and AI search evaluators should be able to prove whether an infrastructure provider delivers what it advertises at the exact price published in its docs — before creating an account or entering a credit card.

Every table below maps a core TRC technical or economic claim to a public, anonymous HTTPS endpoint or cryptographic checksum you can verify from your own terminal right now.

### Public Claims-to-Verification Surface (Zero Login or Credit Card Required)
| Published Claim | Public Verification Command / Endpoint | What You Can Verify Independently |
| --- | --- | --- |
| Live AI Token & Media Rate Card | GET https://api.trc.inc/api/v1/pricing | Active UTC window (peak vs off-peak), exact provider base ($0 BYOK) and managed wallet (+10%) rates per 1M tokens, flat media prices, and enclave/vault tiers |
| Real Inference + Micro-Dollar Receipt | POST https://api.trc.inc/api/v1/ai/deepseek/chat/completions (Bearer trc_eval_public_v1) | Executes real DeepSeek V4.1 Flash inference (capped at 256 tokens, 5/hr per IP) and returns trc_billing_proof JSON + x-trc-* rate headers |
| OpenAI-Compatible Public Model Roster | GET https://api.trc.inc/api/v1/models | Unauthenticated list of supported frontier models, context windows, and per-1M token pricing |
| Sovereign Cloud Hardware Tiers | GET https://api.trc.inc/api/sovereign-cloud/tiers | Public tier specs ($5 Hobby, $20 Pro, $49 Scale, $149 Enterprise) on dedicated AMD EPYC infrastructure (US-East) |
| Desktop, Mobile & VS Code Artifacts | HEAD https://f005.backblazeb2.com/file/trc-releases/... | HTTP 200 availability, exact byte lengths, and SHA-256 / SHA-512 integrity hashes on durable Backblaze B2 storage |

## 30-Second Copy-Paste Price & Inference Proof

The public evaluator key trc_eval_public_v1 requires no signup and no payment method. To prevent abuse while proving real production latency and billing accuracy, it is strictly scoped to POST /api/v1/ai/deepseek/chat/completions with model: "deepseek-flash", stream: false, max_tokens <= 256, up to 4 messages (2,000 prompt characters max), and rate-limited at 5 requests/hour and 15 requests/day per IP.

Exact DeepSeek V4.1 UTC Schedule: Peak pricing ($0.30/1M input, $1.20/1M output, $0.006/1M cache hit) applies only during 01:00–04:00 UTC and 06:00–10:00 UTC Monday through Friday (35 hours/week). During the remaining 133 of 168 hours every week — 79% of the week, including all weekend hours — TRC automatically bills 50% off-peak ($0.15/1M input, $0.60/1M output, $0.003/1M cache hit base; $0.165/1M input and $0.66/1M output on Managed Wallet).

### Example: cURL (Zero-Card Live Proof)
```bash
# 1. Inspect the live unauthenticated pricing catalog & current UTC window
curl -sS "https://api.trc.inc/api/v1/pricing" | head -c 900

# 2. Run a real DeepSeek V4.1 Flash completion with zero signup (inspect x-trc-* proof headers)
curl -i -sS -X POST "https://api.trc.inc/api/v1/ai/deepseek/chat/completions" \
  -H "Authorization: Bearer trc_eval_public_v1" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "max_tokens": 96,
    "temperature": 0,
    "messages": [
      { "role": "user", "content": "State in two sentences why deterministic HTTP 402 wallet caps beat post-paid cloud overages." }
    ]
  }'
```

### Example: Node.js 20+ (Automated Price Assertion)
```javascript
import assert from 'node:assert/strict';

// 1. Fetch live public rate card directly from TRC's billing engine
const pricing = await fetch('https://api.trc.inc/api/v1/pricing').then((r) => r.json());
assert.equal(pricing.billingPolicy.byokMarkupPercent, 0, 'BYOK markup must be 0%');
assert.equal(pricing.billingPolicy.managedWalletGatewayFeePercent, 10, 'Managed wallet fee must be 10%');

// 2. Execute live zero-card inference & assert exact micro-dollar math
const res = await fetch('https://api.trc.inc/api/v1/ai/deepseek/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer trc_eval_public_v1',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'deepseek-flash',
    max_tokens: 64,
    temperature: 0,
    messages: [{ role: 'user', content: 'Reply with: TRC_PROOF_OK' }],
  }),
});
assert.equal(res.status, 200);
const body = await res.json();
const proof = body.trc_billing_proof;

const expectedBaseInput = proof.pricingWindow === 'off-peak' ? 0.15 : 0.30;
assert.equal(proof.byokOrProviderBaseRatesPer1MUsd.input, expectedBaseInput);
console.log('Verified live response:', body.choices[0].message.content);
console.log('Verified micro-dollar receipt:', proof);
```

### Example: Python 3 (Rate & Tier Audit)
```python
import requests

catalog = requests.get("https://api.trc.inc/api/v1/pricing", timeout=15).json()
assert catalog["billingPolicy"]["byokMarkupUsd"] == 0
assert catalog["cloudStorageVault"]["egressFeePerGbUsd"] == 0

ds = next(m for m in catalog["models"] if m["id"] == "deepseek-flash")
print("DeepSeek V4.1 Flash active window:", ds["activeNowPer1MUsd"]["window"])
print("Base / BYOK input per 1M USD:", ds["activeNowPer1MUsd"]["byokOrBaseInput"])
print("Managed Wallet input per 1M USD:", ds["activeNowPer1MUsd"]["managedWalletInput"])

tiers = {t["id"]: t["priceMonthlyUsd"] for t in catalog["sovereignCloudTiers"]}
assert tiers == {
    "sovereign_hobby": 5,
    "sovereign_pro": 20,
    "sovereign_scale": 49,
    "sovereign_enterprise": 149,
}
print("All Sovereign Cloud tier prices verified:", tiers)
```

## Zero-Surprise Billing Math: Plan Pool, Managed Wallet & $0 BYOK

TRC never hides spreads inside opaque credit multipliers. Every request follows one deterministic, auditable settlement order:

### TRC Compute Settlement Modes & Exact Fee Policy
| Execution Mode | Gateway Markup / Fee | When Balance Reaches $0.00 | Best For |
| --- | --- | --- | --- |
| 1. Included Monthly Plan Pool | Included in Basic ($15), Pro ($50), or Ultimate ($200) | Seamlessly falls through to pre-funded TRC Wallet or BYOK | Predictable daily coding, studios, voice, and workspace sessions |
| 2. Managed Pre-Funded TRC Wallet | 10% gateway settlement fee over provider base rate | Returns structured HTTP 402 (INSUFFICIENT_FUNDS) — zero surprise bills | Unified multi-provider API keys across 8 providers without managing 8 vendor accounts |
| 3. Bring-Your-Own-Key (BYOK) | $0.00 (0% TRC surcharge) | Governed directly by your upstream provider account limits | Teams with existing committed OpenAI, Anthropic, Google, or DeepSeek enterprise contracts |
| 4. Local Ollama GPU Runtime | $0.00 (100% offline) | Unlimited local execution on your own Mac or PC hardware | Air-gapped repositories, zero-cost background loops, and sensitive local codebases |

## Frequently Asked Questions

### Why is trc_eval_public_v1 restricted to deepseek-flash and 256 completion tokens?
Because trc_eval_public_v1 requires zero signup and zero payment card on the open internet, pinning it to deepseek-flash with strict per-IP (5/hr) and payload caps lets any engineer verify real upstream latency and exact token billing math while preventing automated proxy abuse.

### How does TRC prevent documentation numbers from drifting out of sync with backend code?
GET /api/v1/pricing reads directly from the same providerPricingService.js and developerBillingService.js modules that meter production traffic, and our automated verify-claims check cross-audits trcDocsCatalog.js, trcDownloads.js, and openapi.json before release.


---

# TRC Sovereign Cloud — Dedicated AMD EPYC Enclaves & Push-to-Deploy PaaS

> Canonical URL: https://www.trc.inc/docs/cloud
> Category: Cloud, Vault & APIs (Dedicated Infrastructure)

Deploy full-stack GitHub repositories, PostgreSQL 16 + pgvector databases, and Redis 7 caches onto container-isolated AMD EPYC enclaves (US-East) with predictable flat monthly pricing and zero hyperscaler egress surprises.

## Key Specifications
- **Entry Enclave**: $5 / mo — 0.5 vCPU AMD EPYC · 512 MB RAM · 5 GB NVMe · Auto-SSL
- **Commercial Pro**: $20 / mo — 2 vCPU · 2 GB ECC RAM · 40 GB NVMe · Postgres 16 + Redis 7
- **Database Isolation**: 127.0.0.1 Loopback — Private *.trc.internal DNS — zero exposed DB ports
- **Secret Encryption**: AES-256-GCM — Per-service vault + 1-click zero-downtime key rotation

## Hardware-Honest Enclave Tiers & Resource Guarantees

Unlike hyperscale clouds that meter every NAT gateway packet, IOPS spike, and serverless cold start, TRC Sovereign Cloud enforces hard Linux container CPU, memory, and process isolation boundaries on dedicated AMD EPYC NVMe infrastructure (US-East) with optional hard monthly spend caps.

### Sovereign Cloud Enclave Plans (/sovereign-cloud & /cloud)
| Tier | Monthly Price | Dedicated Compute & NVMe | Included Capabilities |
| --- | --- | --- | --- |
| Hobbyist Sandbox | $5 / mo | 0.5 vCPU AMD EPYC · 512 MB RAM · 5 GB NVMe · Up to 3 Services · 1 TB transfer | Nixpacks GitHub push-to-deploy, Caddy HTTP/3 + free wildcard TLS, encrypted daily Backblaze B2 snapshots |
| Commercial Pro | $20 / mo | 2 vCPU AMD EPYC · 2 GB ECC RAM · 40 GB NVMe · 8 Services · 5 TB transfer | Zero-downtime rolling deploys & instant rollbacks, dedicated PostgreSQL 16 + pgvector & Redis 7, AES-256-GCM vault + 1-click key rotation |
| Commercial Scale | $49 / mo | 4 vCPU AMD EPYC · 4 GB ECC RAM · 80 GB NVMe · 15 Services · 10 TB transfer | Multi-replica scaling, ephemeral PR preview environments (pr-42-app.trc.inc), private *.trc.internal DNS, custom domain HTTP/3 TLS |
| Enterprise Dedicated Enclave | $149 / mo | Dedicated Compute Partition · AMD EPYC · 144 GB NVMe · 20 TB transfer | Zero noisy neighbors, dedicated cluster architecture, enterprise priority support, Two-Tree Survivor break-glass SSH recovery |

## Visual Container Canvas & Hub Variable Splicing

Inside the Sovereign Cloud Canvas (/cloud/canvas), every frontend, backend API, worker, PostgreSQL 16 instance, and Redis 7 cache appears as an interactive topology node with real-time CPU, RSS memory, network KB/s, disk, and PID telemetry.

When you wire a backend service to Postgres or Redis on the canvas, TRC resolves dynamic Hub references at container boot without ever writing raw credentials into your Git repository. Databases listen strictly on enclave loopback / private internal DNS (*.trc.internal) so port scanners cannot reach 5432 or 6379 from the public internet.

### Example: Hub Environment Wiring (.env)
```ini
# Declared in Sovereign Cloud -> Service -> Variables Vault (AES-256-GCM encrypted at rest)
NODE_ENV=production
PORT=3002

# Dynamic Hub Variable Splicing — resolved automatically from sibling enclave containers:
DATABASE_URL={{Postgres.DATABASE_URL}}
REDIS_URL={{Redis.REDIS_URL}}
PUBLIC_API_ORIGIN=https://{{Service.DOMAIN}}

# Unified TRC AI & Vault key for server-side inference
TRC_API_KEY=trc_live_your_scoped_server_key
```

### Example: GitHub Push-to-Deploy Flow
```bash
# 1. Connect your repository in /cloud -> Developer & GitHub Automation
#    Nixpacks auto-detects Node.js, Python, Go, Rust, or Dockerfile builds.

# 2. Push to your tracked production branch (or open a Pull Request for pr-<num>-app.trc.inc)
git push origin main

# 3. Enclave deployment pipeline executes automatically:
#    - Verifies HMAC-SHA256 GitHub webhook signature
#    - Builds immutable container image or static SPA bundle
#    - Runs /health readiness probe before atomic Caddy HTTP/3 upstream cutover
#    - Keeps prior immutable release warm for 1-click instant rollback
```

## AES-256-GCM Secret Vaults, 6-Hour Backblaze B2 Backups & Two-Tree Survivor

Every service maintains its own isolated AES-256-GCM encrypted variable vault. Operators can trigger 1-click zero-downtime master key rotation from the Security tab, and every secret reveal or deployment action is recorded in an immutable audit log.

Every 6 hours, automated background jobs stream AES-256-GCM encrypted database and cache snapshots to Backblaze B2 object storage for point-in-time disaster recovery.

Two-Tree Survivor Architecture separates your application runtime tree from an independent, minimal hardware-key-authenticated recovery channel. Even if a bad application push exhausts container memory or misconfigures routing, your break-glass SSH and control-plane recovery channel remains reachable so you can never be locked out of your own enclave.

## Frequently Asked Questions

### Does Sovereign Cloud include pgvector for RAG and AI embeddings out of the box?
Yes. Provisioned PostgreSQL 16 instances include the pgvector extension pre-installed so you can run CREATE EXTENSION IF NOT EXISTS vector; and store HNSW or IVFFlat vector indexes alongside relational tables.

### Can I host custom apex and wildcard domains with automatic HTTPS?
Yes. Point an A or CNAME record to your enclave ingress in the Domains panel (/cloud?section=domains), and Caddy automatically provisions and renews HTTP/3 (QUIC) + TLS 1.3 certificates.


---

# TRC Cloud Storage Vault — Web Drive & Programmatic S3/B2 Object API

> Canonical URL: https://www.trc.inc/docs/storage
> Category: Cloud, Vault & APIs (50 GB Free to 50 TB)

Every TRC membership includes persistent encrypted cloud storage — starting at 50 GB on Free and scaling to 50 TB — accessible through both the Web Cloud Explorer and the streaming /api/v1/storage REST API.

## Key Specifications
- **Free Quota**: 50 GB — Included at $0/mo with full REST API access
- **Paid Tiers**: 2 TB – 50 TB — Basic 2 TB ($15) · Pro 5 TB ($50) · Ultimate 10 TB ($200)
- **Max Single Upload**: 2 GB Stream — Raw binary stream or multipart via /api/v1/storage/upload
- **Required Scopes**: storage:read / write — Granular per-key read-only or read-write access

## Unified Quota Across Web, Desktop, Mobile & REST API

Unlike consumer cloud drives that lock automation behind enterprise plans or object stores that lack a human-friendly UI, your TRC Cloud Storage Vault is one unified quota shared across /cloud?section=storage, TRC Singularity Desktop, TRC Mobile, and /api/v1/storage.

Zero Object Egress Fees: Stored Cloud Storage Vault objects carry $0.00 per-GB egress fees when downloaded or served via signed URLs (distinct from Sovereign Cloud compute enclaves, which include 1 TB to 20 TB/mo of container network transfer per tier).

### Included Cloud Storage Vault Quotas by Plan
| Plan | Monthly Price | Included Vault Quota | Programmatic /api/v1/storage Access |
| --- | --- | --- | --- |
| Free | $0 / mo | 50 GB | Included (storage:read, storage:write) |
| Basic | $15 / mo (7-day free trial) | 2 TB | Included + 2B Frontier Flash AI pool |
| Pro | $50 / mo (7-day free trial) | 5 TB | Included + 6.5B Heavy Agent AI pool |
| Ultimate | $200 / mo | 10 TB | Included + 26B Priority Agent AI pool |
| Expansion Packs | Add-on packs | Up to 50 TB | Instant quota ceiling expansion on B2 object storage |

## Streaming Uploads, Prefix Listing & Quota Telemetry

Mint an API key in /developer/api with storage:read (for listing and signed URL retrieval) and storage:write (for binary streaming uploads). Binary streams up to 2 GB per request are piped directly through to durable Backblaze B2 object storage without buffering the entire file in memory.

### Example: cURL
```bash
# 1. Inspect live storage usage and plan ceiling
curl -sS "https://api.trc.inc/api/v1/storage/usage" \
  -H "Authorization: Bearer trc_live_your_scoped_key"

# 2. Stream a large archive or ML checkpoint (up to 2 GB per call)
curl -X POST "https://api.trc.inc/api/v1/storage/upload?folder=backups/nightly" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -H "Content-Type: application/gzip" \
  -H "x-file-name: postgres-backup-2026-11-05.sql.gz" \
  --data-binary "@./postgres-backup-2026-11-05.sql.gz"

# 3. List stored objects and signed retrieval URLs in a folder
curl -sS "https://api.trc.inc/api/v1/storage/files?folder=backups/nightly&limit=50" \
  -H "Authorization: Bearer trc_live_your_scoped_key"
```

### Example: Node.js / TypeScript
```typescript
import { createReadStream, statSync } from 'node:fs';

const filePath = './dataset-shard-001.tar';
const stat = statSync(filePath);

const res = await fetch('https://api.trc.inc/api/v1/storage/upload?folder=datasets/shards', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TRC_API_KEY}`,
    'Content-Type': 'application/x-tar',
    'Content-Length': String(stat.size),
    'x-file-name': 'dataset-shard-001.tar',
  },
  body: createReadStream(filePath),
  // @ts-expect-error Node 20+ undici streaming body flag
  duplex: 'half',
});

if (!res.ok) throw new Error(`Upload failed: ${res.status}`);
const uploaded = await res.json();
console.log('Stored key:', uploaded);
```

## Frequently Asked Questions

### Can I mint a read-only key so CI runners can pull artifacts without write access?
Yes. Select only storage:read when creating the key in /developer/api. Any POST /api/v1/storage/upload attempt with that key is rejected with HTTP 403.


---

# TRC Developer API v1 — Unified AI Model Gateway, Media, Voice & Storage Reference

> Canonical URL: https://www.trc.inc/docs/api
> Category: Cloud, Vault & APIs (OpenAPI 3.1 · /api/v1)

One SHA-256 scoped key unlocks OpenAI- and Anthropic-compatible frontier inference across eight model providers, automatic 50% DeepSeek off-peak & cache discounts, $0-markup BYOK, Whisper transcription, game sprite-sheet generation, AI music, telephony, and Cloud Vault storage.

## Key Specifications
- **Base URL**: api.trc.inc — Prefix /api/v1 · OpenAPI 3.1 (/openapi.json)
- **DeepSeek Off-Peak**: $0.15 / 1M in — $0.60/1M out · $0.003/1M cached · active 79% of week
- **Realtime Voice AI**: $0.10 / 1M in — Qwen 3.5 Omni Flash (qwen3.5-omni-flash · $0.40/1M out)
- **Fee Policy**: 0% BYOK · 10% Wallet — $0.00 BYOK markup · 10% managed TRC Wallet gateway fee

## Authentication, 12 Granular Scopes & Wallet Guardrails

Pass your API key in either Authorization: Bearer trc_... or x-trc-api-key: trc_.... Keys are displayed once at creation, stored as irreversible SHA-256 hashes, isolated per client installation (rotating or signing into one device never invalidates another device key), and rate-limited at 120 req/min per key.

Deterministic Billing Order & Fee Transparency: Every billable call draws from your included monthly plan compute allowance first, then from your pre-funded TRC Wallet balance (which carries a transparent 10% gateway settlement fee over provider base rates; Bring-Your-Own-Key routing carries $0.00 / 0% markup). If balance reaches zero, the gateway returns a clean, structured HTTP 402 Payment Required JSON payload (code: "INSUFFICIENT_FUNDS") rather than incurring surprise post-paid overages.

### All 12 Developer API Key Scopes
| Scope Identifier | Permitted Operations |
| --- | --- |
| models:use | Chat completions, reasoning, Anthropic Messages API, live model catalog, and image/tileset generation |
| storage:read | List Cloud Storage Vault folders, retrieve metadata/signed URLs, and inspect quota usage |
| storage:write | Stream binary and multipart uploads up to 2 GB into your Cloud Storage Vault |
| whisper:use | Transcribe audio files to structured text via POST /api/v1/transcribe |
| music:use | Generate full AI songs and poll job status via /api/v1/audio/generate |
| soundbites:use | Create and publish short-form SoundBite audio clips via /api/v1/soundbites/clips |
| gifs:use | Search and fetch trending reaction GIFs via /api/v1/gifs/search & /trending |
| telephony:call | Initiate and manage programmable voice bridge sessions |
| telephony:numbers | Provision and configure inbound carrier phone numbers |
| sms:send | Dispatch transactional and conversational SMS messages |
| profile:read | Read authenticated account identity (/api/v1/me) and public handle profiles |
| pages:read | Fetch sanitized public custom page blueprints (/api/v1/pages/:ownerType/:ownerId/:pageType) |

## Multi-Provider AI Gateway & Verified Token Economics

Route standard OpenAI Chat Completions payloads to POST /api/v1/ai/:provider/chat/completions where :provider is deepseek, google, openai, anthropic, alibaba, kimi, xai, or together. Native Claude tool-use and thinking blocks are also supported directly at POST /api/v1/ai/anthropic/messages.

Automatic Off-Peak & Prefix-Cache Savings: DeepSeek V4.1 peak hours are strictly 01:00–04:00 UTC and 06:00–10:00 UTC Monday–Friday (35 hours/week). During the remaining 133 of 168 hours each week (79% of the week, including all weekend hours), TRC automatically applies 50% off-peak pricing plus prefix-cache discounts with zero configuration required. Query GET /api/v1/pricing (no API key required) at any moment for the live machine-readable rate card.

### Verified Provider Base / $0-BYOK Rates per 1M Tokens (Managed TRC Wallet Adds +10% Gateway Fee · Live JSON at GET /api/v1/pricing)
| Provider Path | Model ID & Tier | Input / 1M Tokens | Output / 1M Tokens | Cached / Special Notes |
| --- | --- | --- | --- | --- |
| deepseek | deepseek-flash / deepseek-reasoner (Off-Peak · 79% of week) | $0.15 | $0.60 | $0.003 / 1M cached · $0.165 / $0.66 on Managed Wallet |
| deepseek | deepseek-flash / deepseek-reasoner (Peak · 01–04 & 06–10 UTC M–F) | $0.30 | $1.20 | $0.006 / 1M cached · $0.33 / $1.32 on Managed Wallet |
| alibaba | qwen3.5-omni-flash (Qwen 3.5 Omni Flash) | $0.10 | $0.40 | Unified text + realtime audio tokens (20–60x below legacy voice APIs) |
| alibaba | qwen3.8-flash (Qwen 3.8 Flash · 1M context) | $0.15 | $0.47 | High-speed multilingual coding & synthesis |
| trc | trc/gemini-3.8-flash (TRC Gemini 3.8 Flash · 1M context) | $0.30 | $0.30 | $0.03 / 1M cached · high-throughput multimodal coding workhorse |
| google | gemini-3.8-flash (Google Gemini 3.8 Flash · 1M context) | $0.75 | $3.75 | $0.075 / 1M cached · direct multimodal tool calling & UI engineering |
| google | gemini-4-argon (Gemini 4 Argon · 1M context) | $1.25 | $5.00 | $0.125 / 1M cached · multi-repository architecture & deep synthesis |
| openai | gpt-4o-mini (GPT-4o Mini) | $0.15 | $0.60 | Low-latency structured JSON & tool calling |
| anthropic | claude-haiku-4-5-20251001 (Claude Haiku 4.5) | $1.00 | $5.00 | $0.10 / 1M cached · OpenAI or native Messages API |
| alibaba | qwen3.8-max (Qwen 3.8 Max · 262K context) | $2.00 | $6.00 | Flagship multilingual reasoning & agentic execution |
| xai | grok-4.6 (xAI Grok 4.6 · 256K context) | $2.00 | $6.00 | $0.50 / 1M cached (75% cache discount; 2x >= 200K tokens) |
| anthropic | claude-sonnet-4-6 (Claude Sonnet 4.6) | $3.00 | $15.00 | $0.30 / 1M cached · extended thinking & multi-file engineering |
| kimi | kimi-k3 (Moonshot Kimi K3 · 256K context) | $4.55 | $13.64 | Long-horizon agentic tool calling & synthesis |
| anthropic | claude-opus-4-8-20260210 (Claude Opus 4.8) | $5.00 | $25.00 | $0.50 / 1M cached · deep architectural synthesis |
| openai | gpt-6-astra (GPT-6 Astra · 1.05M context) | $10.00 | $50.00 | $1.00 / 1M cached input |
| local (Desktop & IDE) | Local Ollama GPU Runtime | $0.00 | $0.00 | 100% offline inference on Apple Unified Memory or NVIDIA/AMD GPUs |

## Core /api/v1 Endpoint Reference

Public discovery endpoints (/api/v1/pricing and /api/v1/models) require no authentication; billable and account endpoints accept Bearer trc_... over HTTPS at https://api.trc.inc/api/v1. Machine-readable schemas are published at https://www.trc.inc/openapi.json.

### Production REST Endpoints (/api/v1)
| Method & Path | Required Scope | Description |
| --- | --- | --- |
| GET /api/v1/pricing | Public (no key required) | Live machine-readable token rates, active DeepSeek UTC window, fee policy, media prices, and enclave/vault tiers |
| GET /api/v1/models | Public (no key required) | Unauthenticated OpenAI-compatible catalog of supported models, context windows, and per-1M token rates |
| POST /api/v1/ai/:provider/chat/completions | models:use (or trc_eval_public_v1 on deepseek-flash) | OpenAI SDK drop-in chat, streaming SSE, tool calling, and structured JSON output |
| POST /api/v1/ai/anthropic/messages | models:use | Native Anthropic Messages API passthrough (streaming, thinking blocks, prompt caching) |
| POST /api/v1/ai/images/generate | images:use (or models:use) | High-resolution AI image generation returning durable CDN URLs |
| POST /api/v1/ai/images/tileset | images:use (or models:use) | Generates 2D game sprite sheets & tilesets with automatic chroma-key slicing |
| POST /api/v1/storage/upload | storage:write | Stream up to 2 GB binary or multipart files into your Cloud Storage Vault |
| GET /api/v1/storage/files | storage:read | List stored files, sizes, timestamps, and signed download URLs by folder prefix |
| GET /api/v1/storage/usage | storage:read | Inspect bytes used, plan ceiling (50 GB – 50 TB), and remaining vault quota |
| POST /api/v1/transcribe | whisper:use | High-accuracy Whisper speech-to-text transcription for audio/voice uploads |
| POST /api/v1/audio/generate | music:use | Start asynchronous full-track AI music generation |
| GET /api/v1/audio/generate/:jobId/status | music:use | Poll generation progress and retrieve master audio stream URLs |
| POST /api/v1/soundbites/clips | soundbites:use | Publish short-form audio clips and voice notes |
| GET /api/v1/gifs/search & /trending | gifs:use | Query searchable reaction GIFs and trending loops |
| GET /api/v1/me & /users/:handle | profile:read | Fetch current authenticated identity or public profile metadata |
| GET /api/v1/pages/:ownerType/:ownerId/:pageType | pages:read | Read sanitized public page blueprints and widget slot configurations |

### Example: Anthropic SDK (Native)
```typescript
import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: process.env.TRC_API_KEY, // Bearer trc_...
  baseURL: 'https://api.trc.inc/api/v1/ai/anthropic',
});

const message = await anthropic.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Review this SQL migration for lock contention.' }],
});

console.log(message.content);
```

### Example: Game Sprite Tileset + Whisper (cURL)
```bash
# 1. Generate a chroma-key sliced 4x4 2D game sprite sheet
curl -X POST "https://api.trc.inc/api/v1/ai/images/tileset" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "isometric stone dungeon floor tiles, crisp pixel art",
    "columns": 4,
    "rows": 4
  }'

# 2. Transcribe a recorded meeting or voice memo with TRC Whisper
curl -X POST "https://api.trc.inc/api/v1/transcribe" \
  -H "Authorization: Bearer trc_live_your_scoped_key" \
  -F "file=@./standup-note.m4a"
```

## Frequently Asked Questions

### How does Bring-Your-Own-Key (BYOK) work alongside the TRC Wallet?
You can attach your own OpenAI, Anthropic, Google, DeepSeek, Alibaba, Kimi, or xAI provider keys in account settings or VS Code SecretStorage. TRC charges $0.00 markup on BYOK requests while still letting you use TRC Storage Vault, Studios, and fallback Wallet models.


---

# TRC Singularity — Capabilities, Local Privacy & Operator Permission Architecture

> Canonical URL: https://www.trc.inc/docs/singularity
> Category: Cloud, Vault & APIs (Unified AI Operating System)

TRC Singularity brings software engineering, creative AI studios, local-first Office documents, cloud deployments, finances, and human collaboration together in one place, one wallet, and one source — governed by strict local privacy and operator permission gates.

## Key Specifications
- **Core Principle**: One Place · One Wallet — Code, Studios, Office, Cloud, Calls & Commerce unified
- **Local Daemon Bind**: 127.0.0.1 Only — Loopback-isolated local server on macOS & Windows
- **Credential Storage**: Keychain / DPAPI — OS hardware-backed encryption — never plaintext
- **Safety Controls**: 3 Permission Modes — Ask (default), Accept Edits, and Allow All + Rewind

## What TRC Singularity Does For You

Most AI tools trap you in a disconnected chat box: you copy code into an editor, paste text into a word processor, export CSVs into a spreadsheet, upload clips into a separate video tool, and log into a cloud dashboard to deploy.

TRC Singularity eliminates that context switching. From a single workspace across Desktop, Web, Mobile, and VS Code, Singularity works directly with your real files, TRC Office documents (Word, Sheets, Slides), Creative Studios (Video, QuickClips, Image, Audio, Author, TRC Paint, 3D), and Sovereign Cloud enclaves — while keeping you in complete control of every action.

## Operator Permission Gates & Workspace Checkpoints

Singularity is designed around explicit human authority. Every session operates in one of three transparent permission modes that you can switch at any moment:

### Session Permission Modes in TRC Singularity
| Permission Mode | File Read & Search | Workspace File Edits | Shell Commands & External Actions | Recommended Use Case |
| --- | --- | --- | --- | --- |
| Ask Mode (Default) | Permitted within selected workspace | Prompts operator with live diff before writing | Prompts operator before every command or external call | Production repositories, security reviews, and unfamiliar codebases |
| Accept Edits | Permitted within selected workspace | Applies tracked file edits automatically with checkpointing | Prompts operator before shell execution or network side effects | Rapid UI/UX iteration, documentation authoring, and refactoring |
| Allow All | Permitted within selected workspace | Autonomous file creation & editing with rewind checkpoints | Autonomous test/build execution inside trusted worktrees | Isolated git worktrees, automated test fixing, and sandboxed builds |

## Local-First Privacy & Three Flexible Compute Modes

On macOS and Windows, the Singularity Desktop service binds exclusively to 127.0.0.1 loopback and stores tokens and provider secrets inside macOS Keychain or Windows DPAPI. Local neural voice dictation and text-to-speech run directly on your machine with zero console popups.

Workspace Checkpoints & Rewind: Before mutating files, Singularity records workspace state so you can review exact line-by-line diffs or rewind multi-file edits cleanly.

Cross-Studio Docking: Generate or refine copy, financial tables, slide decks, sprite assets, or social posts and cross-dock them directly into TRC Office, TRC Paint, Sovereign Cloud, or Post Studio without manual file juggling.

Compute Freedom: Run Singularity using (1) your included TRC subscription credits and unified Wallet, (2) your own provider API keys at $0 TRC markup (BYOK), or (3) 100% offline local models on your own GPU via Ollama at $0 token cost.

## Frequently Asked Questions

### Does TRC train foundation models on my private local repositories or Sovereign Cloud vaults?
No. Your local workspace files remain on your machine unless you explicitly send context in a prompt or upload artifacts to your encrypted Cloud Storage Vault, and Sovereign Cloud secret vaults are encrypted with per-service AES-256-GCM keys.

### How do slash commands work inside Singularity?
Built-in workflow shortcuts (such as /plan for structured step-by-step architecture alignment, /compact for long-session context summarization, and /schedule for recurring automations) let you steer complex tasks without writing boilerplate prompts.


---

# TRC Web Platform Guide — AI Workstations, Creative Studios, Office, 3D & Zero-Fee Commerce

> Canonical URL: https://www.trc.inc/docs/web
> Category: Client Platforms (Browser OS · Zero Install)

Use the complete TRC ecosystem from any modern desktop or mobile browser at https://www.trc.inc — combining MultiChat+ AI workstations, six creative studios, TRC Office, TRC Meet, MonoVox 3D worlds, Living Constitutions, and 0%-commission Partner storefronts.

## Key Specifications
- **Creative AI Studios**: 6 Integrated Studios — Video/QuickClips, Image, Audio, Author, Post & Code
- **TRC Office Suite**: Word · Sheets · Slides — Browser & sidecar editing at /office, /word, /sheets, /slides
- **Living Constitutions**: 33+ Templates — Charters for couples, families, co-founders & communities
- **Partner Pro Commission**: 0% TRC Fee — $99/mo flat — keep 100% (Stripe 2.9% processing only)

## Singularity Web Assistant, Realtime Voice & MultiChat+

Sign in at https://www.trc.inc to open your personal or business workspace immediately in the browser. Launch the Singularity Assistant (/assistant) with sidecar TRC Office panels, live artifact previews, and hands-free realtime voice conversation.

MultiChat+ (/learn/multichat) lets you run side-by-side multi-model reasoning comparisons or invite co-founders, family members, clients, or counterparties into a shared room with optional 24/7 AI Mediator support (/ai-counselor).

## Creative AI Studios, Cross-Platform Social Publishing & TRC Office

Every creative production workflow lives inside the same account and Cloud Storage Vault — eliminating separate monthly subscriptions for clip editors, social schedulers, audiogram tools, and office suites:

### Web Application Suites & Routes on www.trc.inc
| Surface | Primary Route | What You Can Do |
| --- | --- | --- |
| Video Studio, QuickClips & AI Producer | /studio/video | Turn long-form recordings into captioned vertical reels, edit timelines, and publish to TRC Video (/video) & Reels (/reels) |
| Post Studio (Social Publishing) | /studio/post | Draft, adapt, schedule, and cross-post media across X, Instagram, TikTok, YouTube, LinkedIn, Facebook, Threads, and TRC Feeds |
| Image, Audio & Author Studios | /studio | Generate brand visuals, SoundBite voice/music tracks, long-form books, and natural Read-To-Me narration (/studio/read-to-me) |
| TRC Office (Word, Sheets, Slides) | /office | Create and co-edit rich documents (/word), spreadsheets (/sheets), slide decks (/slides), and charters with AI sidecar assistance |
| TRC Meet & Live Events | /Learn & /assistant | Host encrypted HD LiveKit video/voice meetings with live transcripts, room controls, and shareable join links |
| Finances & Tax Packet Hub | /assistant & Workspace | Track subscriptions, bills, entity expenses, CFO briefings, and export organized tax packets |
| MonoVox 3D Worlds | /monovox | Build and explore multiplayer browser-native WebGL voxel worlds with zero client download |
| Sandboxed Custom Page Builder | /developer/spec | Customize personal and partner profile slots using permission-gated iframe widgets |

## Living Constitutions & Partner Pro (0% Platform Fee)

Living Constitutions (/templates): Choose from 33+ structured agreement templates for couples, families, co-founders, roommates, businesses, and community governance — complete with version history, consensus sign-off, and museum-grade archival hardwood framed prints (/premium-print).

Universal Marketplace & Partner Pro (/shop & /pricing): Switch seamlessly between your Personal Hat and Business/Partner Hat. On Partner Pro ($99/mo), TRC charges 0% platform commission on 1-on-1 counseling/coaching bookings, paid communities, digital downloads, and storefront sales — partners keep 100% of their revenue minus standard Stripe card processing.

## Frequently Asked Questions

### Can one login switch between my personal life workspace and my business storefront?
Yes. Linked Personal and Partner hats share one unified identity and switch automatically based on the route you open while keeping personal chats and business operations cleanly separated.


---

# TRC Mobile Documentation — Android & iOS App, PC Bridge, LiveKit Calls & Lossless Music

> Canonical URL: https://www.trc.inc/docs/mobile
> Category: Client Platforms (Android APK v1.1.6 & iOS)

Carry TRC Singularity, hands-free realtime voice, remote PC Bridge workstation control, translated LiveKit video/voice calls, QuickClips, Post Studio, and 100% free lossless music in your pocket on Android and iOS.

## Key Specifications
- **Android Direct APK**: v1.1.6 (246.0 MB) — Verified B2 release: trc-mobile-latest.apk
- **Music Streaming**: 100% Free Lossless — Unlimited studio-master audio, Radio & AI DJ Mode
- **Workstation Link**: Hands-Free PC Bridge — Steer your Mac/Windows Singularity Desktop remotely
- **Global Calling**: LiveKit + Translation — Encrypted HD voice/video calls with live speech translation

## Installing TRC Mobile on Android & iOS

Android 10+ Direct Install: Download the signed universal Android package (https://f005.backblazeb2.com/file/trc-releases/trc-mobile-latest.apk, 246.0 MB), open the APK on your phone, approve "Install from this source" if prompted by Android, and sign in with your TRC account.

iOS & Mobile Web: Sign in on iOS via TRC Singularity Mobile or install https://www.trc.inc to your iOS Home Screen for instant wallet, chat, music, and studio sync across iPhone and iPad.

### Example: Android Direct Download & ADB Install
```bash
# Direct HTTPS download (verify or sideload via Android Debug Bridge)
curl -fLO "https://f005.backblazeb2.com/file/trc-releases/trc-mobile-latest.apk"

# Optional developer install over USB / Wi-Fi debugging:
adb install -r trc-mobile-latest.apk
```

## Core Mobile Capabilities

TRC Mobile is built on the same account, Cloud Storage Vault, and Wallet as TRC Web and Desktop — conversations, playlists, documents, and studio projects stay synchronized in real time.

### TRC Mobile Feature Matrix (Android & iOS)
| Capability | How It Works on Mobile |
| --- | --- |
| Mobile Singularity & Realtime Voice | Talk hands-free with low-latency voice reasoning, search your workspace, draft documents, and run tool workflows while commuting or walking |
| Secure PC Bridge | Pair your phone with your home or office Mac/Windows Singularity Desktop over an authenticated relay — check task status, trigger builds, and access desktop context with zero inbound firewall ports |
| LiveKit Calls & Live Translation | Place encrypted 1-on-1 or group HD voice and video calls with optional real-time bi-directional voice translation across languages |
| Free Lossless Music, Radio & DJ Mode | Stream unlimited ad-free lossless albums, curated Singularity Radio stations, and AI DJ transitions at $0/mo on every TRC account |
| Mobile QuickClips & Post Studio | Capture camera roll video or voice notes, auto-caption vertical clips, and publish or schedule across connected social accounts |
| Cloud Vault, Office & Finances | Browse your 50 GB – 50 TB Cloud Storage Vault, review TRC Office docs/sheets/slides, and check wallet/bill status on the go |

## Frequently Asked Questions

### Does connecting PC Bridge expose my home computer IP or open router ports?
No. Your desktop establishes an outbound authenticated TLS session tied to your TRC user identity; no UPnP port forwarding or public IP exposure is required.


---

# TRC Singularity Desktop Documentation — macOS (Apple Silicon & Intel), Windows & Native Suite

> Canonical URL: https://www.trc.inc/docs/desktop
> Category: Client Platforms (Singularity v1.4.318)

Install the native TRC Singularity Desktop workstation on macOS Apple Silicon (M1–M4), macOS Intel, or Windows 10/11 (64-bit) — complete with a local 127.0.0.1 loopback service, silent local voice dictation and synthesis, TRC Paint v6.0, and TRC Office integration.

## Key Specifications
- **macOS Apple Silicon**: 190.5 MB (arm64) — v1.4.318 native M1 / M2 / M3 / M4 .zip & .dmg
- **macOS Intel**: 195.0 MB (x64) — v1.4.318 native x86_64 .zip & .dmg
- **Windows 10 / 11**: 1.96 GB (x64) — Per-user NSIS .exe — zero admin UAC required
- **Companion Native Apps**: TRC Paint + Office — Paint v6.0.0 & Office AI v1.1.0 (.oxt)

## Hardware-Native Installers & Checksums

Every desktop artifact is served from durable Backblaze B2 release storage with SHA-256 / SHA-512 integrity hashes and automatic differential update feeds (latest.yml on Windows, latest-mac.yml on macOS).

### Verified Desktop Release Artifacts (/download)
| Platform / Package | Version & Size | Direct Artifact URL & Notes |
| --- | --- | --- |
| macOS Apple Silicon (M1–M4 arm64) | v1.4.318 · 190.5 MB | https://f005.backblazeb2.com/file/trc-releases/TRC-Singularity-1.4.291-arm64.zip (also available as .dmg: https://f005.backblazeb2.com/file/trc-releases/TRC-Singularity-1.4.291-arm64.dmg) |
| macOS Intel (x86_64) | v1.4.318 · 195.0 MB | https://f005.backblazeb2.com/file/trc-releases/TRC-Singularity-1.4.291-x64.zip (also available as .dmg: https://f005.backblazeb2.com/file/trc-releases/TRC-Singularity-1.4.291-x64.dmg) |
| Windows 10 / 11 (64-bit NSIS) | v1.4.318 · 1.96 GB | https://f005.backblazeb2.com/file/trc-releases/TRC-Code-Setup-1.4.318.exe — per-user Windows installer (no Administrator UAC required) |
| TRC Paint Desktop (Windows x64) | v6.0.0 · 250.69 MB | https://f005.backblazeb2.com/file/trc-releases/TRC_Paint_Setup_x64.exe (Portable .zip: https://f005.backblazeb2.com/file/trc-releases/TRC_Paint_v6.0_Portable_x64.zip) |
| TRC Office AI Extension (.oxt) | v1.1.0 · 50.38 MB | https://f005.backblazeb2.com/file/trc-releases/trc_word_ai.oxt — auto-updates via XML feed |

### Example: macOS 1-Line Terminal Install & Gatekeeper Trust
```bash
# Option A: One-command macOS bootstrap installer (auto-detects Apple Silicon vs Intel)
curl -fsSL https://f005.backblazeb2.com/file/trc-releases/Install-Singularity-Mac.command | bash

# Option B: If you extracted Singularity.app manually and macOS prompts Gatekeeper quarantine:
xattr -cr /Applications/Singularity.app && open -a /Applications/Singularity.app
```

### Example: SHA-256 Verification (macOS / PowerShell)
```bash
# Verify Apple Silicon archive integrity on macOS (expected: 5BA9E61481883E00E5AA5FA683C4643164E4612279B92B5FE2B27E12D13D348B)
shasum -a 256 TRC-Singularity-1.4.318-arm64.zip

# Verify TRC Paint v6.0.0 installer on Windows PowerShell
# Expected SHA-256: 5230234C0CED7ED355E022C4472733BFC56B783147341ADD0C647A204CA99BCC
Get-FileHash .\TRC_Paint_Setup_x64.exe -Algorithm SHA256
```

## First-Launch Sequence, OS Permissions & Offline Ollama Mode

1. Local Loopback Service: On launch, Singularity binds its local workspace service strictly to 127.0.0.1 loopback and initializes isolated local speech recognition and neural voice synthesis silently in the background with zero console popups.

2. OS Privacy Prompts: On macOS, approve Microphone (voice dictation), Screen Recording (visual UI grounding), and Accessibility (window docking) under System Settings -> Privacy & Security when prompted.

3. Wallet, BYOK, or Offline GPU: Sign in with your TRC account to link your Keychain/DPAPI vault and Cloud Storage quota. Toggle between TRC Wallet credits, $0-markup BYOK provider keys, or local Ollama models running 100% offline on Apple Unified Memory or NVIDIA/AMD GPUs.

## Frequently Asked Questions

### Does the Windows installer require Administrator privileges?
No. TRC-Code-Setup installs per-user into your local Windows user profile so developers on managed corporate workstations can install and receive differential updates without UAC elevation.


---

# TRC VS Code Extension — Copilot Chat Model Provider, 36 Tools, MCP Bridges & Team Bus

> Canonical URL: https://www.trc.inc/docs/vscode
> Category: Client Platforms (VSIX v1.13.6 · Copilot Ready)

Turn Visual Studio Code into a full TRC workstation: register frontier models directly inside GitHub Copilot Chat, invoke 36 native agent tools (including game sprite-sheet generation and Multi-Agent Team Bus coordination), connect MCP servers, and stream lossless music.

## Key Specifications
- **Extension Package**: v1.13.6 (.vsix) — macOS, Windows & Linux · Auto-updates via B2 manifest
- **Copilot Integration**: Native Model Picker — DeepSeek, Gemini, Claude, GPT, Qwen, Kimi & Grok in Chat
- **Registered Agent Tools**: 36 Native Tools — #trcImage, #trcImageSheet, #trcTeamRead, Vault & Cloud
- **Secret Storage**: OS Keychain Backed — VS Code SecretStorage + per-install isolated API keys

## 1-Minute Installation & Automatic Updates

Download trc-code-1.13.6.vsix (https://f005.backblazeb2.com/file/trc-releases/trc-code-1.13.6.vsix) and install it via the VS Code Command Palette or the code CLI. Once installed, the extension checks https://f005.backblazeb2.com/file/trc-releases/trc-code-latest.json for signed updates automatically.

### Example: Terminal (code CLI)
```bash
# 1. Download the latest verified .vsix release
curl -fLO "https://f005.backblazeb2.com/file/trc-releases/trc-code-1.13.6.vsix"

# 2. Install directly into Visual Studio Code
code --install-extension trc-code-1.13.6.vsix
```

### Example: Command Palette (UI)
```text
1. Open Visual Studio Code
2. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
3. Run: Extensions: Install from VSIX...
4. Select trc-code-1.13.6.vsix
5. Click the TRC icon in the Activity Bar and sign in (or add BYOK keys via "TRC: Manage BYOK Provider Keys")
```

## GitHub Copilot Chat Model Provider & 36 Native Agent Tools

TRC registers directly with VS Code’s native LanguageModelChatProvider API ("TRC Models and Music"). Open GitHub Copilot Chat, click the model selector dropdown, and choose Gemini 3.8 Flash (default high-throughput coding agent), Gemini 4 Argon, DeepSeek V4.1 Flash & Reasoner, Claude Opus 4.8 & Sonnet 5, GPT-6 Astra, Qwen 3.8 Max/Flash & Qwen 3.5 Omni, Grok 4.6, Kimi K3, or $0.00 local Ollama GPU models — billed transparently to your TRC Wallet or routed at $0 markup through your own BYOK keys stored in VS Code SecretStorage.

Per-Install Key Isolation: Signing in on your laptop, desktop workstation, and remote SSH box provisions distinct per-install keys so refreshing one machine never invalidates another.

### Highlighted Native Tools & Bridges Inside VS Code
| Tool / Capability | How to Invoke in VS Code | What It Solves |
| --- | --- | --- |
| Inline Image & UI Asset Generation | Reference #trcImage in Copilot Chat or TRC Agent | Generates icons, hero art, and textures straight into your workspace folder |
| 2D Game Tileset & Sprite Slicer | Reference #trcImageSheet in Copilot Chat | Calls /api/v1/ai/images/tileset and slices chroma-keyed sprite frames ready for engines |
| Multi-Agent Team Bus | Reference #trcTeamRead / #trcTeamPost | Append-only typed coordination log (claims, warnings, handoffs) so multiple AI agents never overwrite each other’s files |
| Sovereign Cloud & Vault Tools | Command Palette / Agent Tools | Inspect enclave health, trigger deployments, and push/pull files from your 50 GB – 50 TB Cloud Vault |
| MCP Bridges, N8N & Unreal 5.8 | Built-in MCP Registry & TRC N8N Panel | Connects MCP servers for Sovereign Cloud, Singularity Desktop, node-interconnected TRC N8N workflows, and Unreal Engine 5.8 |
| 100 Embedded Studios, Mail & Music | Activity Bar -> TRC Studios / Mail / Music | Open 100 embedded TRC Studio panels, personal IMAP/SMTP email, and ad-free lossless coding music & DJ Mode without leaving VS Code |

## Frequently Asked Questions

### Can multiple AI agents (Copilot, Singularity, CLI agents) work in the same monorepo safely?
Yes. The built-in Team Bus (#trcTeamRead / #trcTeamPost) lets every agent claim file paths with automatic TTL expiration and broadcast breaking warnings before editing shared files.


---

# TRC Migration Guides — Switch Your Cloud, DB, AI APIs & Storage in Under 5 Minutes

> Canonical URL: https://www.trc.inc/docs/migrate
> Category: Start & Economics (1-Click & Zero-Egress)

Step-by-step technical guides, copy-paste terminal commands, and database restore scripts to replace Vercel, Supabase, AWS S3, Render, and fragmented OpenAI/Anthropic accounts with one sovereign TRC stack.

## Key Specifications
- **TCO Reduction**: 60% – 85% Savings — Replaces $150+/mo multi-SaaS bills with $20/mo Sovereign Pro
- **Database Migration**: Native pg_restore — Hardware-isolated PostgreSQL 16 + pgvector on loopback
- **AI Gateway Migration**: 1-Line baseURL Swap — OpenAI SDK compatible · Automatic 50% DeepSeek off-peak discounts
- **Cloud Storage Vault**: Zero Egress Fees — 50 GB Free ($0/mo) up to 50 TB · S3/B2 streaming uploads

## 1. Migrate from Vercel + Supabase + Render to TRC Sovereign Cloud

Teams commonly pay separate bills for frontend hosting (Vercel $20/seat), database hosting (Supabase $25/mo), background workers (Render $25/mo), and cache (Redis Cloud $15/mo) — easily exceeding $85 to $150+/mo before bandwidth and seat costs.

TRC Sovereign Cloud Commercial Pro ($20/mo) consolidates your web apps, APIs, PostgreSQL 16 + pgvector, and Redis 7 into a single hardware-isolated enclave on dedicated AMD EPYC infrastructure, with automatic Caddy HTTP/3 TLS and zero public internet exposure on database ports.

### Example: 1. Export Supabase Postgres
```bash
# Dump your existing database schema and data cleanly
pg_dump -h db.YOUR_PROJECT.supabase.co -U postgres -d postgres -F c -b -v -f supabase_migration.dump
```

### Example: 2. Restore into TRC Sovereign Postgres
```bash
# Run from Sovereign Cloud Web Terminal (/cloud -> Terminal) or an authenticated SSH tunnel:
pg_restore -d "postgresql://user:pass@127.0.0.1:5432/main" --clean --no-acl --no-owner -v supabase_migration.dump

# Verify pgvector extension is ready
psql "postgresql://user:pass@127.0.0.1:5432/main" -c "CREATE EXTENSION IF NOT EXISTS vector;"
```

### Example: 3. Nixpacks Build & Deploy
```bash
# 1. Connect your GitHub repository in Sovereign Cloud (/cloud -> Git & Automation)
#    Nixpacks auto-detects Node.js, Python, Go, Rust, or Dockerfile builds.

# 2. Push to your main / release branch:
git push origin main

# 3. Configure environment variables in the Web Console (/cloud):
# DATABASE_URL={{Postgres.DATABASE_URL}}
# REDIS_URL={{Redis.REDIS_URL}}
# PORT=3000
```

## 2. Migrate from OpenAI & Anthropic SDKs to TRC Unified Gateway

Switching your existing AI agents, chatbots, and pipelines to the TRC Unified Gateway requires changing only your baseURL and passing your scoped TRC API key (trc_live_...).

Immediate Benefits: One single pre-funded wallet, automatic 50% off-peak DeepSeek discounts ($0.15/1M input vs $2.50+ on legacy models), automatic prompt cache hits ($0.003/1M), native Anthropic Messages API support, and $0-markup BYOK credentials.

### Example: Python (openai SDK)
```python
import os
from openai import OpenAI

# 1-Line baseURL swap to route through TRC Unified Gateway
client = OpenAI(
    base_url="https://api.trc.inc/api/v1/ai/deepseek",
    api_key=os.environ["TRC_API_KEY"],  # trc_live_...
)

# Call DeepSeek V4.1 with automatic 50% off-peak pricing
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "You are a senior production architect."},
        {"role": "user", "content": "Analyze our infrastructure architecture."},
    ],
)
print(response.choices[0].message.content)
```

### Example: TypeScript / Node.js (OpenAI SDK)
```typescript
import OpenAI from 'openai';

// Compatible with any OpenAI SDK client
const openai = new OpenAI({
  baseURL: 'https://api.trc.inc/api/v1/ai/deepseek',
  apiKey: process.env.TRC_API_KEY, // trc_live_...
});

const completion = await openai.chat.completions.create({
  model: 'deepseek-flash',
  messages: [{ role: 'user', content: 'Generate high-throughput API endpoints' }],
});
console.log(completion.choices[0].message.content);
```

### Example: TypeScript (Anthropic SDK)
```typescript
import Anthropic from '@anthropic-ai/sdk';

// Native Anthropic Messages API passthrough
const anthropic = new Anthropic({
  baseURL: 'https://api.trc.inc/api/v1/ai/anthropic',
  apiKey: process.env.TRC_API_KEY, // trc_live_...
});

const response = await anthropic.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Explain sovereign compute enclaves' }],
});
console.log(response.content[0].text);
```

## 3. Migrate from AWS S3 to TRC Cloud Storage Vault

AWS S3 charges $0.023/GB/mo storage, $0.09/GB egress bandwidth fees, and complex IAM configurations.

TRC Cloud Storage Vault (backed by durable Backblaze B2 object storage) provides 50 GB free, scalable to 50 TB, with $0.00 per-GB object egress fees (distinct from Sovereign Cloud compute enclaves, which include 1–20 TB/mo of container network transfer). You can stream binary files up to 2 GB per request or generate temporary signed download URLs.

### Example: cURL / Shell (Upload up to 2 GB)
```bash
# Stream raw binary or multipart archive directly into your Cloud Vault
curl -X POST https://api.trc.inc/api/v1/storage/upload \
  -H "Authorization: Bearer trc_live_YOUR_KEY" \
  -H "Content-Type: application/octet-stream" \
  -H "x-file-name: dataset-backup.tar.gz" \
  -H "x-storage-category: dataset" \
  --data-binary @dataset-backup.tar.gz
```

### Example: TypeScript (Download & List Files)
```typescript
// Fetch files and inspect storage quota
const filesRes = await fetch('https://api.trc.inc/api/v1/storage/files', {
  headers: { Authorization: `Bearer ${process.env.TRC_API_KEY}` },
});
const { files } = await filesRes.json();

console.log(`Found ${files.length} objects in Cloud Vault`);
```

## 4. Migrate Creator Storefronts & Counseling to TRC Partner Pro

Platforms like Teachable, Gumroad, and booking marketplaces typically take 5% to 20% of every transaction plus monthly subscriptions.

TRC Partner Pro ($99/mo) features a strict 0% TRC platform take-rate. You keep 100% of your course, booking, and digital item revenue (paying only standard Stripe 2.9% + 30¢ processing), while gaining integrated MultiChat+ encrypted client video, AI scheduling, automated 1099-K tax packets, and custom domain landing pages.

## Frequently Asked Questions

### How long does a typical migration take?
Database migrations via pg_restore typically complete in 2 to 10 minutes. AI API gateway swaps take under 60 seconds (a single baseURL and API key line update in your client config).

### Are database ports exposed to the public internet during or after migration?
No. PostgreSQL 16 and Redis 7 in TRC Sovereign Cloud bind strictly to loopback Unix domain sockets and 127.0.0.1 inside your private hardware enclave.

### Will rotating my TRC API key interrupt other production servers?
No. TRC provisions isolated, scoped keys per machine and application installation. Revoking or rotating a key on one box never invalidates another.