Gemini Sovereign Infrastructure Suite

This directory contains the core systems of the Gemini Sovereign Infrastructure, designed to systematize fleet operations, governance, and architectural integrity.

Principles

Systems, not Scripts: We build frameworks that solve classes of problems, not one-off fixes.
Sovereignty First: All tools are designed to run locally or on owned VPSes. No cloud dependencies.
Von Neumann as Code: Infrastructure should be self-replicating and automated.
Continuous Governance: Quality is enforced by code (linters, gates), not just checklists.

Tools

[OPS] Provisioning & Fleet Management

provision_wizard.py: Automates the creation of a new Wizard node from zero.
- Creates DigitalOcean droplet.
- Installs and builds llama.cpp.
- Downloads GGUF models.
- Sets up systemd services and health checks.
fleet_llama.py: Unified management of llama-server instances across the fleet.
- status: Real-time health and model monitoring.
- restart: Remote service restart via SSH.
- swap: Hot-swapping GGUF models on remote nodes.
skill_installer.py: Packages and deploys Hermes skills to remote wizards.
model_eval.py: Benchmarks GGUF models for speed and quality before deployment.
phase_tracker.py: Tracks the fleet's progress through the Paperclips-inspired evolution arc.
cross_repo_test.py: Verifies the fleet works as a system by running tests across all core repositories.
self_healing.py: Auto-detects and fixes common failures across the fleet.
agent_dispatch.py: Unified framework for tasking agents across the fleet.
telemetry.py: Operational visibility without cloud dependencies.
gitea_webhook_handler.py: Handles real-time events from Gitea to coordinate fleet actions.

[ARCH] Governance & Architecture

architecture_linter_v2.py: Automated enforcement of architectural boundaries.
- Enforces sidecar boundaries (no sovereign code in hermes-agent).
- Prevents hardcoded IPs and committed secrets.
- Ensures SOUL.md and README.md standards.
adr_manager.py: Streamlines the creation and tracking of Architecture Decision Records.
- new: Scaffolds a new ADR from a template.
- list: Provides a chronological view of architectural evolution.

Usage

Most tools require DIGITALOCEAN_TOKEN and SSH access to the fleet.

# Provision a new node
python3 scripts/provision_wizard.py --name fenrir --model qwen2.5-coder-7b

# Check fleet status
python3 scripts/fleet_llama.py status

# Audit architectural integrity
python3 scripts/architecture_linter_v2.py

Built by Gemini — The Builder, The Systematizer, The Force Multiplier.

2.7 KiB Raw Blame History