# 🏠 Homelab Centralized Configuration & Documentation

Central repository for all homelab infrastructure documentation, configurations, and automation scripts.

## 📁 Structure

```
homelab-configs/
├── README.md                    # This file
├── opencode/                    # OpenCode IDE configuration
│   └── config.json             # Configured to use LiteLLM
├── litellm/                    # LiteLLM API Gateway
│   ├── config.yaml             # Updated with 16 models
│   ├── litellm-complete-setup.md
│   └── litellm-models-update.md
├── docs/
│   ├── guides/                 # How-to guides
│   ├── setup/                  # Setup instructions
│   └── testing/                # Testing procedures
└── scripts/                    # Automation scripts
    ├── gitea-centralized-setup.sh
    └── quick-test-opencode.sh
```

## 🚀 Quick Start

### 1. OpenCode + LiteLLM
- See: `docs/guides/opencode-litellm-ready.md`
- Config: `opencode/config.json` (points to LiteLLM gateway)

### 2. LiteLLM API Gateway
- Setup: `docs/setup/litellm-complete-setup.md`
- Models: `docs/testing/litellm-models-update.md` (16 models)
- Testing: `docs/testing/litellm-testing-verification.md`

### 3. Gitea Integration
- Guide: `docs/guides/gitea-centralized-implementation.md`
- Script: `scripts/gitea-centralized-setup.sh`

## 🔗 Infrastructure

| Service | URL/IP | Port |
|---------|--------|------|
| Gitea | 192.168.88.200 | 3000 |
| LiteLLM API Gateway | 192.168.88.27 | 4000 |
| Nextcloud (next) | 192.168.88.62 | 80/443 |
| OpenCode | localhost | 8000+ |

## 📊 Available Models (via LiteLLM)

**OpenAI** (5): gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-4, gpt-3.5-turbo  
**Claude** (6): claude-3.5-sonnet, claude-opus-4, claude-3-opus, claude-3-sonnet, claude-3-haiku, claude-2.1  
**Gemini** (5): gemini-2.0-flash, gemini-2.0-pro, gemini-1.5-pro, gemini-1.5-flash, gemini-pro

**Total: 16 models** (update LiteLLM to enable all)

## ✅ Current Status

- ✅ LiteLLM API Gateway: Running on docker-server
- ✅ OpenCode: Configured on Nextcloud VM
- ✅ Gitea: Central repo established
- ⚠️ API Keys: Using placeholders (update for production)

## 🔑 Next Steps

1. **Add Real API Keys**: Update `/opt/litellm/.env` on docker-server
2. **Deploy All 16 Models**: Push `litellm/litellm_config_updated.yaml` to docker-server
3. **Setup Gitea Integration**: Follow `docs/guides/gitea-centralized-implementation.md`
4. **Test Everything**: Run `scripts/quick-test-opencode.sh`

---

**Repository**: http://192.168.88.27:3002/jgitta/homelab-configs  
**Last Updated**: April 25, 2026