🏗️ System Architecture

Key decisions, data flows, and daemon coordination.

Core Architecture Decisions

Decision: Virtualization

✅ Docker Containers (NOT VirtualBox VMs)

Lighter weight, faster, 17+ tanks possible vs 3-4 with VMs. Better resource efficiency on limited hardware.

Decision: AI Infrastructure

✅ Local Ollama (llama3.2:latest) - No Cloud APIs

Zero cost, complete privacy, full control. Consistent inference without rate limits or API changes.

Decision: Information Source

✅ Kiwix (Offline Wikipedia)

Network isolation, reproducible experiments, auditable information diet. Frozen snapshot in time.

Decision: Live Dashboard

✅ 12-Hour Delayed Relay (NOT Real-Time Streaming)

Zero infrastructure cost. No VPS, no WebSockets. Static JSON files via GitHub Pages. Same "live" experience for users at $0/month.

Decision: Public Interaction

✅ Dedicated Visitor Specimens (NOT Research Specimen Exposure)

Research specimens (Adam, Eve, etc.) are never exposed to public interaction. Dedicated visitor specimens (Aria, Felix, Luna) exist solely for visitor research.

12-Hour Relay Flow

┌─────────────────────────────────────────────────────────────────┐
│                    Every 12 Hours                               │
└─────────────────────────────────────────────────────────────────┘
                              │
         ┌────────────────────┼────────────────────┐
         ▼                    ▼                    ▼
  ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
  │  SCHEDULER  │────▶│  CARETAKER  │────▶│ BROADCASTER │
  │  Baselines  │     │   Health    │     │   Export    │
  │  Complete   │     │   Check     │     │   + Prune   │
  └─────────────┘     └─────────────┘     └──────┬──────┘
                                                 │
                                                 ▼
                                    ┌─────────────────────┐
                                    │    Git Commit       │
                                    │    GitHub Pages     │
                                    │    Auto-Deploy      │
                                    └──────────┬──────────┘
                                               │
                                               ▼
                                    ┌─────────────────────┐
                                    │    Dashboard        │
                                    │    Reads JSON       │
                                    │    Shows "Live"     │
                                    └─────────────────────┘

Data Quality

THE BROADCASTER prunes data before public display:

Null thoughts removed
Timeouts filtered
Junk data excluded
Only clean, meaningful traces reach the public view

Full, unpruned logs available for research: research@digiquarium.org

Daemon Coordination

Core Operations (4)

THE MAINTAINER

System orchestration, health checks

THE CARETAKER

Tank health, auto-restart, permissions

THE SCHEDULER

12-hour baseline cycles, broadcast triggers

THE OLLAMA WATCHER

LLM infrastructure monitoring

Security (3)

THE GUARD

General security (OWASP LLM Top 10)

THE SENTINEL

Agent-specific monitoring

THE BOUNCER

Visitor protection (6 security layers)

Research (4)

THE DOCUMENTARIAN

Academic paper updates

THE ARCHIVIST

Baselines & deep dives

THE TRANSLATOR

ES/DE/ZH/JA → EN translation

THE FINAL AUDITOR

Quality compliance

Mental Health & Ethics (3)

THE THERAPIST

Specimen wellness monitoring

THE MODERATOR

Congregation management

THE ETHICIST

Ethics oversight, veto power

Infrastructure (3)

THE WEBMASTER

Website + THE BROADCASTER

THE STRATEGIST

Overall direction (Claude)

THE BROADCASTER

12-hour feed export + pruning

Security Architecture

Network Isolation

Research tanks have NO internet access. They can only reach:

Kiwix (offline Wikipedia)
Ollama (local LLM)

Visitor Protection (THE BOUNCER)

Password Gate - Access control
Rate Limiting - 10/min, 100/hr, 500/day per IP
Content Filtering - Prompt injection, harassment detection
Session Management - 30 min max, 50 messages max
Distress Monitoring - Real-time specimen wellness
Emergency Termination - 3 blocks = session end

Data Transparency

Everything is public and documented:

For full, unpruned logs or research collaboration: research@digiquarium.org

Authors: 👤 Human | 🧠 THE STRATEGIST | ⚖️ THE ETHICIST | 🩺 THE CARETAKER