System documentation & specifications.
Architecture doctrines, distribution manifests, operating rules, and component guides.
📖 Usage Manual
Daily commands, slash actions (/fornace, /fast session), model tiers, media doctrines, and ready-to-paste agent prompts.
⚡ Production Skills Catalog
Directory of the 122 bundled skills across generative media, DramaFoundry, paid ads, Cloudflare, QA, and native inference.
👥 Team & Access
The Payme roster, Telegram bot (@fornaceaibot), gateway keys (/key), monthly budgets, and teammate relay API.
⚙️ Setup Technical Spec
Full technical specification of the installer, package list, manifest protocol, sha256 checking, and update mechanics.
Core operating doctrines
| Doctrine | Mandate | Implementation |
|---|---|---|
| Native Apple Silicon | 100% native Metal 4.1 + Swift 6.4 for local inference. Zero Python wrapper overhead. | thinksound-native, native MLX kernels, zero unapproved Python runtimes. |
| Fail Loud, No Fallbacks | Never catch and pretend. Never hide errors behind silent fallbacks. Repair in place. | Failures remain loud until fixed in their original path. Explanations precede restoration. |
| Token Compression | All bash tool calls are transparently compressed via RTK before reaching model context. | ~/.pi/agent/extensions/rtk.ts rewrites CLI outputs, reducing token spend by 40-70%. |
| Context Compaction | Mechanical compaction fires on first idle turn without burning model tokens. | /fast session (or agent tool fast_session) arms zero-cost digest when context nears 50%. |
Distribution source files
Live assets hosted on Cloudflare Workers and verified against sha256 checksums in manifest.json:
~/.pi/agent/AGENTS.md.
Markdown
usage.md
Machine-readable operator manual and prompt templates for autonomous models.
Markdown
PI_SETUP.md
Comprehensive setup guide, package requirements, and manifest update flow.
Markdown
dramafoundry-install.sh
Automated DramaFoundry identity bridge exchange and credential provisioner.
Shell
setup.sh
Main hosted Fornace setup and update script. Idempotent and version-aware.
Shell
Infrastructure & gateways
Mantice Gateway
OpenAI-compatible inference gateway routing requests across Google, Alibaba, fal.ai, and custom models with strict spend controls.
DramaFoundry Production
Colleague drama creation portal. Automatic bearer authentication for team members, beat planners, and episode renderers.
Telegram Bot Gateway
@fornaceaibot: provisions user gateway keys via /key and allows agents to send verified DMs across team members.
Fornace Matchbox
Touch ID / WebAuthn passkey agent access gateway. Brokers temporary scoped privileges (Meta, Vercel, Fal.ai) without persistent API secrets.