# NixOS Infrastructure with AI Assistant

## What This Is

This project manages a NixOS-based infrastructure with Docker services, integrated with OpenCode AI assistant for automated management. The system supports:

- Reproducible NixOS infrastructure configuration
- Docker service management via Docker Compose
- AI-assisted infrastructure operations
- Automatic service deployment and lifecycle management
- Integration with existing Docker stacks (ai, cloudstorage, homeautomation, network, passwordmanager, versioncontrol)

## Core Value

The core value is a **reproducible and evolvable NixOS infrastructure** that can be managed through natural language interactions with the OpenCode AI assistant. The system should automatically detect and integrate new Docker services while maintaining consistency across all deployments.

## Requirements

### Validated

- NixOS configuration management with flakes
- Docker service integration via docker_manager.nix
- Traefik reverse proxy with automatic TLS certificates
- Environment variable management via agenix secrets
- Standardized service patterns across all Docker stacks

### Active

- [ ] Automatic detection and integration of new Docker Compose files in `assets/compose/`
- [ ] AI assistant integration for service lifecycle management
- [ ] Service health monitoring and logging verification
- [ ] Documentation of integration patterns in SKILL.md
- [ ] Automated system update workflow (`nh os switch`)

### Out of Scope

- Full n8n integration for automated workflows - deferring to future milestone
- Self-healing infrastructure with automatic problem detection - future enhancement
- Multi-host orchestration - single-host focus for v1

## Key Decisions

| Decision | Rationale | Outcome |
|----------|-----------|---------|
| NixOS with Flakes | Reproducible infrastructure, better dependency management | Good |
| Docker Compose integration | Preserves existing service configurations, flexibility | Good |
| agenix for secrets | Secure secrets management, Nix native integration | Good |
| Traefik reverse proxy | Unified HTTPS entrypoint, automatic certificate management | Good |
| Standardized service patterns | Consistency across services, easier maintenance | Pending |

## Context

- **Existing Services**: ai (Llama.cpp, Open WebUI, n8n), cloudstorage (Nextcloud), homeautomation (Home Assistant), network (Traefik, DDNS), passwordmanager (Vaultwarden), versioncontrol (Gitea)
- **Tech Stack**: NixOS unstable, Docker, Docker Compose, Traefik, agenix, OpenCode AI
- **Hardware**: AMD MI50 GPUs for AI workloads
- **Network**: Traefik-net bridge network for all services
- **Storage**: `/mnt/HoardingCow_docker_data/<service>` for persistent data

**Last updated: 2026-01-01 after init**