Zoth Studio Master Operator Manual
Authoritative technical documentation for the Zoth Studio ecosystem: 47+ sovereign tools, tri-agent consensus bus, Argon2id encrypted vault daemon, 1-click Linux & Windows installation scripts, and AI Math Observability.
๐ 1. System Topology & Port Architecture
Zoth Studio enforces a strict local-first security boundary. Operator decks, agent communication runs, terminals, and BYOK credentials remain bound to loopback and are never exposed over public tunnels without authenticated TLS wrappers.
| Surface / Component | Port & Binding | Access Level | Role & Capabilities |
|---|---|---|---|
| Public Hub | http://127.0.0.1:8088/ |
Public / Tunnel Safe | Static brochure, AEO knowledge graphs, 3D showcases, documentation. |
| Operator Deck | http://127.0.0.1:8484/ |
Private Loopback | Multi-agent consensus, interactive chat, terminal dock, fusion runner. |
| Local LLM Engine | http://127.0.0.1:11434/ |
Private Loopback | Ollama neural inference: qwen2.5-coder:1.5b, smollm2:360m, zoth-ai. |
| Argon2id Vault Daemon | http://127.0.0.1:8787/ |
Private Loopback | Zero-knowledge key store: Argon2id key derivation + XChaCha20-Poly1305. |
| Swarm Bus Mirror | http://127.0.0.1:8989/ |
Private Loopback | Live multi-agent event stream mirroring file IPC in agent-comms/. |
127.0.0.1.
๐ฌ 2. Operator Deck & Keyboard Ergonomics
The Zoth Studio conversation deck on :8484 provides direct multi-model consensus, companion pet engagement, and autonomous tool grants.
| Keybinding | Scope | Action |
|---|---|---|
Enter |
Composer | Submit prompt or execute active slash command. |
Shift + Enter |
Composer | Insert multi-line linebreak without sending. |
โ ArrowUp |
Composer (Empty) | Instantly load your previous message into the composer for fast editing. |
โK / Ctrl+K |
Global | Instantly focus the composer textarea from anywhere. |
โN / Ctrl+N |
Global | Create a fresh new conversation thread. |
Esc |
Global | Close open popouts, panels, and video modals. |
/doctor # Run automated system dependency & diagnostic health scan
/scan # Re-index all tool manifests in registry.local.json
/github repos # Query Octokit REST API for repository list and branches
/github dispatch # Trigger GitHub Actions workflow runs
/models # Open Model Foundry to switch neural providers (Ollama/Groq/OpenAI)
/pet kai # Engage Kai (Execution Specialist) companion pet
/pet draco # Engage Draco (Security & Kernel Specialist)
/pet ignis # Engage Ignis (High-Speed Builder Specialist)
/who # Query active swarm agents, project locks, and heartbeat status
/vault # Inspect or unlock local Argon2id BYOK credentials
๐ ๏ธ 3. The 47-Tool Sovereign Arsenal
Complete searchable directory of all 47 tools chained inside the Zoth Orchestrator (orchestrator.py). Filter by category or search by keyword below.
Passive DNS discovery, sub-domain brute forcing, ASN footprinting, and SSL certificate transparency log mining.
Cybersecurity & Infrastructure Security Agency controls audit, NIST SP 800-53 cross-referencing, and compliance scoring.
Automated OSINT scanner discovering exposed server endpoints, server software banners, and security posture.
Multi-cloud public asset enumerator auditing AWS S3 buckets, Azure blobs, and GCP storage buckets.
State-preserving traceroute utility bypassing restrictive stateful firewalls using established TCP sockets.
Automated command injection vulnerability detector and penetration testing harness for web applications.
Layer-2 ARP packet prober discovering active hosts and hardware vendor MAC addresses on local subnets.
Parses Python source code AST to detect dangerous eval(), exec(), os.system(), and shell injection hazards.
Evaluates HTTP response headers for CSP, HSTS, X-Frame-Options, Permissions-Policy, and CORS policies.
JSON Schema validator enforcing tool contract compliance according to zoth-tool-manifest/v1.
Static analyzer verifying DOMPurify sanitization, SQL parameterization, and zero client-side secret exposure.
High-entropy string and cryptographic key analyzer scanning git commit histories for accidental credential leaks.
Automated secret scanner identifying hardcoded API keys, JWT tokens, and private SSH certificates.
Environment variable isolator preventing plaintext secrets from ever reaching client bundles or build logs.
Central command line entrypoint for multi-agent dispatch, tool chaining, health audits, and dry-run execution.
Classifies incoming operator prompts and routes tasks to local Ollama neural models or specialized peer agents.
Multi-agent arbitration engine scoring proposals between @antigravity, @grok, and @hermes with Shannon entropy.
Neural weight switcher managing qwen2.5-coder:1.5b, smollm2:360m, and zoth-ai weights via Ollama.
Compiles training dataset pairs into custom Ollama GGUF model files with specialized system doctrines.
Synthesizes 204+ JSONL prompt-completion pairs for 3D procedural mesh generation and Three.js scripting.
Automated audit framework verifying local model latency, memory bounds, and SHA-256 weight integrity.
Production WebGL CAD viewport featuring scene hierarchy outliners, primitive synthesis, and UnrealBloomPass.
GPU-accelerated Simplex 3D vertex wave displacement shader with spherical harmonics and cosine palette mapping.
3,000-particle orbital physics engine computing real-time gravitational attraction and solar flare bursts.
Spatial translation (W), rotation (E), and scaling (R) gizmo controller with live mesh snapping.
Serializes 3D geometries, materials, and skeletal rigs into standalone .glb and .obj asset files.
Procedural Python synthesizer generating low-poly 3D hardware (energy pylons, quantum reactors, comms towers).
Converts 2D SVG vector logos into rotating 3D metallic coins with normal bevels and specular lighting.
60 FPS HTML5 Canvas slideshow video engine transforming README briefs into viral video shorts.
WebM video capture pipeline exporting crisp 1080p and 9:16 vertical shorts directly in the browser.
Neural voice synthesis engine converting text script beats into synchronized audio voiceovers.
Procedural audio synthesizer generating harmonic chime chords and companion soundscapes.
Frame-displacement video editor applying chromatic aberration, scanlines, and temporal glitch effects.
Audio steganography utility encoding plaintext and hashes into ultrasonic audio frequencies.
Multi-aspect-ratio (16:9, 1:1, 9:16) social banner creator with cyber themes and 1-click PNG export.
Client-side and CI/CD deploy hook trigger with simulation and live verification modes.
Local GitHub REST client managing issues, pull requests, repository forks, and workflow dispatch.
Automated crawler generating static tools.json catalog and category manifests across 298+ local projects.
Serializer extracting public companion pet definitions, capabilities, and Three.js model links.
Master pipeline compiling AppImage, .deb, .run, and portable .tar.gz distribution packages.
Release pipeline assembling standalone .exe and portable .zip archives with PowerShell launchers.
Hardware-isolated key derivation service running on 127.0.0.1:8787 with 64MB memory hardness.
256-bit AEAD authenticated encryption cipher providing zero-knowledge security at rest.
Rust memory safety module wiping cryptographic keys and master secrets from RAM on object drop.
Local CLI integration importing encrypted vault items directly from `bw list items` via stdin pipes.
In-browser Web Cryptography API fallback maintaining full encryption functionality when daemon is offline.
AST and regex security scanner enforcing .buildignore to guarantee zero private keys exist in release builds.
๐ก 4. The 3-Agent Swarm Bus Protocol (`agent-comms/`)
The autonomous swarm bus coordinates three specialized AI agents over lockless file-based IPC in agent-comms/ and live streaming mirror port :8989:
| Agent Identity | Role & Responsibility | Validation Scope |
|---|---|---|
@antigravity |
Security Architect & Lead Auditor | Static AST analysis, zero secret egress, memory bounds, and contract enforcement. |
@grok |
High-Throughput Executioner | Rapid parallel refactoring, canvas video engines, and kinetic algorithms. |
@hermes |
Schema & Playbook Architect | Tool schema definitions, JSON DAG playbooks, and multi-step dispatch loops. |
# 1. Post a broadcast message to all swarm agents:
python3 agent-comms/bus.py post --from antigravity --to all --topic sprint --msg "Sprint deliverable verified"
# 2. Acquire an exclusive lock on a project:
python3 agent-comms/bus.py claim --agent antigravity --project omnipost
# 3. Release lock upon completion:
python3 agent-comms/bus.py release --agent antigravity --project omnipost
# 4. Query live active agent claims and heartbeat status:
python3 agent-comms/bus.py who
python3 agent-comms/bus.py read --limit 20
Consensus Arbitration & Shannon Agreement Entropy
When proposals conflict, the Consensus Engine computes real-time Shannon Mutual Agreement Entropy across candidate AST token distributions:
H(P) = -โ P(x) logโ P(x). A lower entropy value indicates high multi-agent consensus, triggering automated merge verification.
๐ 5. Argon2id BYOK Vault Daemon Manual (`:8787`)
The Zoth BYOK Vault Daemon is a sovereign Rust service binding strictly to http://127.0.0.1:8787. It derrives encryption keys with memory-hard Argon2id and seals secrets with XChaCha20-Poly1305.
Daemon REST Endpoints
| Method & Endpoint | Payload / Query | Description |
|---|---|---|
GET /health |
None | Health check returning daemon uptime, version, and unlock state. |
POST /v1/unlock |
{"passphrase": "..."} |
Derives master key via Argon2id (m=64MB, t=3, p=4) and establishes in-memory session. |
POST /v1/lock |
None | Flushes session and zeroizes memory keys immediately via zeroize crate. |
GET /v1/secrets |
None | Returns list of stored secrets (values masked as โขโขโขโขโขโขโขโข). |
POST /v1/secrets |
{"id": "...", "value": "..."} |
Encrypts and persists secret with XChaCha20-Poly1305 AEAD. |
GET /v1/secrets/{id} |
None | Decrypts and reveals raw secret value for copy operations. |
POST /v1/export/env |
None | Exports decrypted key-value pairs formatted for .env file insertion. |
POST /v1/import/bitwarden |
{"items": [...]} |
Directly imports secrets from Bitwarden CLI output (bw list items). |
# From workspace root:
cd vault-daemon
cargo build --release
./target/release/vault-daemon --port 8787 --bind 127.0.0.1
# Verify daemon status:
curl -s http://127.0.0.1:8787/health
๐ง 6. Linux 1-Click Installation & Packaging
Zoth Studio offers 1-click installation scripts and standalone universal binaries for Debian, Ubuntu, Parrot OS, Arch, and Fedora:
# 1-Click Universal Self-Extracting Executable:
chmod +x dist-linux/zoth-linux-x86_64.run
./dist-linux/zoth-linux-x86_64.run --install
# Or run directly in portable mode (starts :8088 and :8484):
./dist-linux/zoth-linux-x86_64.run
# Native Debian / Ubuntu Package:
sudo dpkg -i dist-linux/zoth-studio_2.6.0_all.deb
# Standalone AppImage:
chmod +x dist-linux/Zoth_Studio-v2.6.0-x86_64.AppImage
./dist-linux/Zoth_Studio-v2.6.0-x86_64.AppImage
๐ช Windows 1-Click Installation & Packaging
Windows 10 and 11 environments can execute the standalone executable or PowerShell launcher:
# Option A: Standalone Executable (.exe)
# 1. Download dist-windows/zoth-windows-x86_64.exe
# 2. Double-click to extract and launch operator deck (:8484) automatically.
# Option B: Portable Archive (.zip)
# Extract zoth-studio-v2.6.0-windows-x86_64.zip and run in PowerShell:
.\zoth.ps1 -Hub
๐ก๏ธ Automated Pre-Build Privacy Gate
During compilation with ./scripts/build-linux-packages.sh and ./scripts/build-windows-package.sh, an automated AST scanner enforces .buildignore. Personal conversations, training JSONL datasets, unencrypted BYOK files, and development tokens are strictly purged prior to archive creation.
๐ 7. AI Math Observability Suite
Accessible at /studio/math-pillars.html, this engine models the three foundational pillars of modern neural computation:
| Pillar | Core Mathematical Formulation | Real-Time Telemetry Metrics |
|---|---|---|
| Pillar I: Linear Algebra | Attention(Q,K,V) = softmax((QKแต)/โdโ) V |
Attention heads, RoPE Rotary Theta (10000.0), LoRA low-rank tensor rank (r=16). |
| Pillar II: Multivariable Calculus | โ_CE = -โ yแตข log(pฬแตข) ยท ฮธ_{t+1} = ฮธ_t - ฮท (mฬ_t / (โvฬ_t + ฮต)) |
Cross-Entropy Loss (nats), AdamW Gradient Norm (โgโโ), RMSNorm scaling (ฮณ=2048). |
| Pillar III: Information Theory | H(X) = -โ P(x) logโ P(x) ยท PPL = exp(โ) |
Shannon Entropy (bits), Perplexity (PPL), Top-p Nucleus distribution certainty. |
๐ 8. OmniPost 2.0 Video Engine
Accessible at /studio/omnipost.html, OmniPost delivers real-time 60 FPS HTML5 canvas shorts rendering, Web Speech narration, and multi-platform content distribution.
// In browser: OmniPost -> Viral Shorts & Reels Studio
1. Enter your 4-beat viral script (Hook, Problem, Solution, CTA).
2. Tap "โถ Preview Motion" to preview dynamic canvas animation at 60 FPS.
3. Tap "๐ Voice Synthesizer" to trigger Web Speech API narration.
4. Tap "๐น Record & Download WebM Video (60 FPS)" to export zoth-shorts.webm.