Thierry Pouplier
b54760f62b
Creates PROJECT.md with vision and requirements. Creates config.json with interactive workflow mode.
2.7 KiB
2.7 KiB
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