Initial commit: TZZR Orchestrator v5

- Framework genérico multi-agente
- Providers: Claude CLI, LiteLLM (100+ modelos)
- Tools: bash, read, write, glob, grep, ssh, http
- Seguridad: sandbox paths, validación comandos, rate limiting
- Configuración via YAML + .env

🤖 Generated with Claude Code

README.md

@@ -0,0 +1,200 @@
+# LLM Orchestrator
+
+Sistema de orquestación multi-agente compatible con cualquier LLM.
+
+## ¿Qué es esto?
+
+Un framework para crear y coordinar múltiples agentes de IA que pueden:
+- Ejecutar comandos en tu sistema
+- Leer y escribir archivos
+- Conectarse a servidores via SSH
+- Hacer llamadas a APIs
+- Trabajar juntos en tareas complejas
+
+## Características
+
+- **Multi-modelo**: Claude, GPT-4, Gemini, Llama, Mistral, y 100+ más
+- **Herramientas universales**: Bash, lectura/escritura de archivos, SSH, HTTP
+- **Agentes personalizables**: Define tantos agentes como necesites
+- **LOGs automáticos**: Registro de todas las acciones
+- **Sin dependencias pesadas**: Solo Python estándar + LiteLLM opcional
+
+## Instalación
+
+```bash
+# Clonar o descomprimir
+cd orchestrator
+
+# Crear entorno virtual
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Instalar dependencias opcionales
+pip install litellm  # Para usar GPT-4, Gemini, Llama, etc.
+```
+
+## Uso rápido
+
+### 1. Define tus agentes
+
+Edita `config.yaml`:
+
+```yaml
+agents:
+  researcher:
+    role: "Investigador que busca información"
+    provider: claude
+    model: sonnet
+    tools: [bash, read, http_request]
+    
+  coder:
+    role: "Programador que escribe código"
+    provider: litellm
+    model: gpt4o
+    tools: [read, write, bash]
+    
+  reviewer:
+    role: "Revisor que valida el trabajo"
+    provider: litellm
+    model: gemini-pro
+    tools: [read, grep]
+```
+
+### 2. Ejecuta el orquestador
+
+```bash
+# Modo interactivo
+python orchestrator/main.py
+
+# Ejecutar un agente específico
+python orchestrator/main.py --agent researcher --prompt "Busca información sobre X"
+
+# Ver estado
+python orchestrator/main.py --status
+```
+
+### 3. Comandos interactivos
+
+```
+/status          - Ver estado del sistema
+/agents          - Listar agentes disponibles
+/agent <nombre>  - Cambiar agente activo
+/logs <agente>   - Ver historial del agente
+/all             - Ejecutar en todos los agentes
+/quit            - Salir
+```
+
+## Estructura
+
+```
+orchestrator/
+├── config.yaml              # ← Tu configuración de agentes
+├── orchestrator/
+│   ├── main.py              # Punto de entrada
+│   ├── config.py            # Carga de configuración
+│   ├── providers/           # Conexión con LLMs
+│   │   ├── claude_provider.py
+│   │   └── litellm_provider.py
+│   ├── tools/               # Herramientas disponibles
+│   │   ├── executor.py
+│   │   └── definitions.py
+│   ├── agents/              # Lógica de agentes
+│   │   └── base.py
+│   └── tasks/               # Tareas predefinidas
+├── logs/                    # Historial por agente
+├── outputs/                 # Archivos generados
+└── examples/                # Ejemplos de configuración
+```
+
+## Providers disponibles
+
+| Provider | Modelos | Requisito |
+|----------|---------|-----------|
+| `claude` | sonnet, opus, haiku | Claude Code CLI instalado |
+| `litellm` | gpt4o, gemini-pro, llama3, mistral... | `pip install litellm` + API keys |
+
+## Herramientas disponibles
+
+| Herramienta | Descripción |
+|-------------|-------------|
+| `bash` | Ejecuta comandos del sistema |
+| `read` | Lee archivos |
+| `write` | Escribe/crea archivos |
+| `glob` | Busca archivos por patrón |
+| `grep` | Busca texto en archivos |
+| `ssh` | Ejecuta comandos en servidores remotos |
+| `http_request` | Hace peticiones HTTP/API |
+| `list_dir` | Lista contenido de directorios |
+
+## Ejemplos
+
+### Agente simple (solo conversación)
+
+```yaml
+agents:
+  assistant:
+    role: "Asistente general"
+    provider: claude
+    model: sonnet
+    tools: []  # Sin herramientas
+```
+
+### Equipo de desarrollo
+
+```yaml
+agents:
+  architect:
+    role: "Diseña la arquitectura del sistema"
+    provider: claude
+    model: opus
+    tools: [read, write, bash]
+    
+  developer:
+    role: "Implementa el código"
+    provider: litellm
+    model: gpt4o
+    tools: [read, write, bash, grep]
+    
+  tester:
+    role: "Escribe y ejecuta tests"
+    provider: litellm
+    model: gemini-pro
+    tools: [read, bash]
+```
+
+### Agentes con servidores
+
+```yaml
+servers:
+  production:
+    host: 192.168.1.100
+    user: deploy
+    key: ~/.ssh/id_rsa
+    
+  staging:
+    host: 192.168.1.101
+    user: deploy
+    key: ~/.ssh/id_rsa
+
+agents:
+  deployer:
+    role: "Despliega aplicaciones a servidores"
+    provider: claude
+    model: sonnet
+    tools: [ssh, bash, read]
+    servers: [production, staging]
+```
+
+## Variables de entorno
+
+Para usar modelos de pago via LiteLLM:
+
+```bash
+export OPENAI_API_KEY="sk-..."
+export GOOGLE_API_KEY="..."
+export ANTHROPIC_API_KEY="..."  # Si usas Claude via API
+```
+
+## Licencia
+
+MIT - Usa, modifica y comparte libremente.