livchat-setup 0.1.4

Automated server setup and application deployment system with AI control via MCP (v0.2.0: DNS-first architecture)

🚀 LivChat Setup

Automated server setup and deployment with AI control

Deploy complete stacks (N8N, Chatwoot, Portainer) on VPS with one command - via Python or Claude AI.

🧪 Beta aberto - Sistema funcional, em desenvolvimento ativo

---

⚡ Instalação

# Python package
pip install livchat-setup

# MCP server (para usar com Claude)
npm install -g @pedrohnas/livchat-setup-mcp

🚀 Quick Start

1. Configure credenciais

# Start API server
livchat-setup serve

# Em outro terminal, configure via Claude ou Python:
# - Hetzner API token
# - Cloudflare API key + email

2. Deploy via Claude AI

// Configure Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "livchat-setup": {
      "command": "npx",
      "args": ["@pedrohnas/livchat-setup-mcp"]
    }
  }
}

Comandos naturais:

"Create server prod-01 type cx21 in region nbg1"
"Setup with DNS zone example.com subdomain prod"
"Deploy N8N"  → Auto-instala postgres + redis!

3. Deploy via Python

from orchestrator import Orchestrator

orch = Orchestrator()
orch.init()

# Create + setup server (~3 min)
orch.create_server_sync("prod-01", "cx21", "nbg1")
orch.setup_server_sync("prod-01", zone_name="example.com", subdomain="prod")

# Deploy infrastructure + app
orch.deploy_app_sync("prod-01", "infrastructure")  # Traefik + Portainer
orch.deploy_app_sync("prod-01", "n8n")             # Auto-resolves dependencies!

✨ Principais Features

• 🤖 AI Control: Gerencie servidores conversando com Claude
• 📦 Auto Dependencies: Deploy N8N instala postgres + redis automaticamente
• 🌐 DNS Automático: Apps recebem domínios prontos (n8n.lab.example.com)
• ⚡ Async Jobs: Operações longas rodam em background com tracking
• 🔐 Secrets Management: Credenciais criptografadas com Ansible Vault
• 🐳 Docker Swarm: Orquestração completa com Traefik SSL automático

📦 Apps Disponíveis

Categoria	Apps
Infrastructure	Traefik, Portainer
Databases	PostgreSQL, Redis
Automation	N8N (auto-instala postgres + redis)
Communication	Chatwoot

Cada app inclui:

• Domain + SSL automático via Traefik
• Resolução de dependências
• Health checks

🔧 Configuração

Secrets necessários

# Via MCP tool "manage-secrets" ou Python
hetzner_token          # API token Hetzner
cloudflare_api_key     # Cloudflare API key
cloudflare_email       # Email do Cloudflare

Storage local

~/.livchat/
├── state.json              # Estado dos servidores + apps
├── credentials.vault       # Secrets criptografados
└── ssh_keys/              # Chaves SSH

🧪 Development

# Run tests
pytest tests/unit/           # Unit tests
pytest tests/integration/    # Integration tests
cd mcp-server && npm test    # MCP E2E tests

# Dev setup
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Structure:

src/          → Core Python (orchestrator, providers, deployer)
apps/         → App definitions (YAML)
ansible/      → Playbooks (setup, deploy)
mcp-server/   → TypeScript MCP integration

📖 Docs

• Architecture: CLAUDE.md
• Plans: plans/
• API: Run livchat-setup docs

🗺️ Roadmap

v0.3.0 (próximo)

• DigitalOcean provider
• Web dashboard
• Backup automation

v1.0.0 (futuro)

• Kubernetes support
• Multi-tenancy
• GitHub Actions integration

📄 Licença

Licença Provisória - ver LICENSE para detalhes

Resumo: Código aberto para aprendizado, uso comercial requer autorização

---

💝 Inspiração & Agradecimentos

Willian - Orion Design Projeto inspirado no SetupOrion

Tecnologias:

• Model Context Protocol (Anthropic)
• Ansible + Docker Swarm + Traefik

---

Made with ❤️ by LivChat Team