Nathan 8ec4b7da8f Add Frank v6 Integration Addendum and Base MCP Server Specification
- Introduced the "Homelab MCP Server — Frank v6 Integration Addendum" document detailing the enhancements brought by Frank v6, including personality layers, specialty domains, and reasoning techniques.
- Updated the base MCP server specification to include comprehensive design decisions, tool catalog, architecture, and security model.
- Added new tools and enriched behaviors for DevOps, Data Analysis, and Prompt Engineering specialties.
- Established a structured command registry for easy access to functionalities across specialties.
- Documented configuration additions for Frank's personality, specialties, reasoning techniques, and knowledge base integration.
2026-05-12 23:02:59 -04:00

Castaldi Family Homelab

A GitOps-managed, Ansible-automated infrastructure running media services, container orchestration, and hypervisor management across distributed ARM and x86 nodes.

GitOps Automation Infrastructure Documentation


🚀 Why This Homelab?

  • Zero-Touch Deployments: Push to Git → Auto-deploy via webhooks → Containers update automatically
  • Ansible Automation: All nodes managed by Ansible from watchtower control plane
  • Infrastructure as Code: Services defined in compose.yaml + infrastructure managed with Ansible playbooks
  • GPU Transcoding: Hardware-accelerated media streaming with NVIDIA GTX 1060 Mobile
  • Distributed Architecture: Services across physical servers with Proxmox hypervisor ready for VM deployment
  • Self-Hosted Git: No external dependencies—Gitea runs on-premise with automated backups
  • Production-Grade Networking: Traefik reverse proxy with automatic SSL (Cloudflare DNS challenge)
  • Hypervisor Management: Proxmox VE ready for VM orchestration with automated post-install configuration

📊 Stats

  • Total Nodes: 5 (1 hypervisor + 3 compute + 1 storage)
  • Automation: Ansible managing 4 active nodes from Watchtower
  • Container Orchestration: Komodo v2.1.2
  • Active Services: 12+ (Traefik, Plex, Tunarr, Gitea, Trek, Vaultwarden, etc.)
  • Total RAM: 62GB (15GB PVE01 + 15GB Heimdall + 16GB Waldorf + 16GB Watchtower)
  • Total CPU Cores: 30 physical (14c i5-13500T + 8c i7-7820HQ + 4c N100 + 4c ARM)
  • Virtualization: Proxmox VE 9.1.7 available (no VMs currently deployed)
  • GPU Acceleration: NVIDIA GTX 1060 Mobile (6GB VRAM)
  • Storage: TerraMaster NAS (NFSv3/v4)

🤝 Contributing

This is a personal homelab, but documentation improvements and issue reports are welcome!

  1. Fork via Gitea: https://git.castaldifamily.com/nathan/homelab
  2. Create feature branch: git checkout -b feat/my-improvement
  3. Commit using Conventional Commits
  4. Push and create Pull Request

📜 License

Personal infrastructure configuration. Documentation licensed under CC BY-SA 4.0.


Maintained by: Nathan Castaldi
Last Updated: April 21, 2026
Status: 🟢
Automation Status: 🟢

Description
A GitOps-managed, Ansible-automated infrastructure running media services, container orchestration, and hypervisor management across distributed ARM and x86 nodes.
Readme 1.2 MiB
Languages
Shell 100%