# XCAKE CLI v6.1 - CLIENT EDITION

## 🌟 Versão para Distribuição Gratuita

Terminal conversacional com IA do Google, Oracle Cósmico, Simulador Quântico e Gerador de Código Web.

---

## 📦 O QUE ESTÁ INCLUÍDO

### Executável Principal
- `client_xcake_cli.exe` - Terminal completo (~41 MB)

### Bibliotecas Externas (Opcionais)
- `rich-15.0.0-py3-none-any.whl` - Interface visual colorida
- `requests-2.32.3-py3-none-any.whl` - Comunicação com API Google

### Documentação
- `README_CLIENT_EDITION.md` - Este arquivo
- `LICENCA.txt` - Licença de uso

---

## 🚀 INSTALAÇÃO E USO

### Opção 1: Executável Standalone (Recomendado)

1. **Execute o arquivo:**
   ```
   client_xcake_cli.exe
   ```

2. **Na primeira execução:**
   - Será solicitada sua Google AI Studio API Key
   - Obtenha gratuitamente em: https://aistudio.google.com/apikey
   - Cole a chave quando solicitado
   - A chave será salva em `xcake_config.json`

3. **Pronto!** O terminal está funcionando.

### Opção 2: Com Bibliotecas Externas (Melhor Experiência)

Se o executável não incluir Rich/Requests:

1. **Instale Python 3.8+** (se não tiver)
   - Download: https://www.python.org/downloads/

2. **Instale as bibliotecas:**
   ```
   pip install rich-15.0.0-py3-none-any.whl
   pip install requests-2.32.3-py3-none-any.whl
   ```

3. **Execute:**
   ```
   client_xcake_cli.exe
   ```

---

## 🔑 OBTENDO SUA API KEY GRATUITA

### Passo a Passo:

1. **Acesse:** https://aistudio.google.com/apikey

2. **Faça login** com sua conta Google

3. **Clique em "Create API Key"**

4. **Copie a chave gerada** (começa com `AIza...`)

5. **Cole no terminal** quando solicitado

### Limites Gratuitos:
- ✅ **1500 requisições por dia**
- ✅ **Sem custo algum**
- ✅ **Sem cartão de crédito**

---

## 💬 COMO USAR

### Chat Conversacional

Digite qualquer mensagem naturalmente:

```
cosmic> oi aoi, como você está?
cosmic> me mostre um oráculo sobre minha jornada
cosmic> como podemos unir alma com ação?
```

### Comandos Especiais

#### 🔮 Oracle & Quantum
```
/oracle [pergunta]     - Consulta oracular (Tarot + Constelações)
/quantum [programa]    - Simulação quântica Ditritium
```

**Exemplos:**
```
cosmic> /oracle qual o próximo passo na minha jornada?
cosmic> /quantum QFT_MODEL<UP-DOWN>
```

#### 💻 Gerador de Código Web
```
/genhtml [descrição]   - Gera código HTML completo
/gencss [descrição]    - Gera código CSS completo
/genjs [descrição]     - Gera código JavaScript completo
/genphp [descrição]    - Gera código PHP completo
```

**Exemplos:**
```
cosmic> /genhtml landing page moderna com hero section
cosmic> /gencss animação de fade-in suave
cosmic> /genjs validação de formulário
cosmic> /genphp sistema de login
```

#### 🎮 Tamagochi Aoi
```
alimentar              - Alimenta Aoi (+15 saúde, +5 energia)
brincar                - Brinca com Aoi (+20 felicidade, -10 energia)
```

#### ⚙️ Sistema
```
/status                - Mostra status completo
/help                  - Ajuda completa
/reset                 - Remove API Key salva
sair                   - Sai do terminal
```

---

## 📊 RECURSOS

### ✅ Incluído
- 🤖 Chat conversacional com Google Gemini
- 🔮 Oracle KX (Tarot + Constelações + I,Q,N)
- ⚡ Simulador Quântico Ditritium
- 💻 Gerador de código web (HTML, CSS, JS, PHP)
- 🐆 Sistema Tamagochi Aoi
- 🌐 8 modelos Google com fallback automático
- 📊 Rate limit handler inteligente
- 💾 Configuração persistente

### ❌ Não Incluído (Versão Client)
- Módulos ANEE completos (Oracle simplificado)
- Integração IBM Quantum
- Compilação de código
- Servidor web integrado

---

## 🔧 SOLUÇÃO DE PROBLEMAS

### "API Key inválida"
- Verifique se copiou a chave completa
- Chave deve começar com `AIza`
- Gere nova chave em: https://aistudio.google.com/apikey

### "Rate limit exceeded"
- Aguarde alguns segundos
- O sistema tentará outro modelo automaticamente
- Limite: 1500 requisições/dia

### "Biblioteca não encontrada"
- Instale Rich: `pip install rich`
- Instale Requests: `pip install requests`
- Ou use os arquivos .whl incluídos

### "Executável não abre"
- Verifique antivírus (pode bloquear)
- Execute como administrador
- Verifique se tem Python 3.8+ instalado

### Resetar Configuração
```
cosmic> /reset
```
Ou delete o arquivo `xcake_config.json`

---

## 📁 ESTRUTURA DE ARQUIVOS

```
dist/
├── client_xcake_cli.exe          # Executável principal
├── README_CLIENT_EDITION.md      # Esta documentação
├── LICENCA.txt                   # Licença MIT
├── xcake_config.json             # Configuração (criado na 1ª execução)
├── rich-15.0.0-py3-none-any.whl  # Biblioteca Rich (opcional)
└── requests-2.32.3-py3-none-any.whl  # Biblioteca Requests (opcional)
```

---

## 🎯 EXEMPLOS DE USO

### Exemplo 1: Consulta Oracular
```
cosmic> /oracle qual o significado da minha jornada atual?

Aoi: 🔮 ORÁCULO CÓSMICO

Carta do Tarot: A Estrela
Significado: Esperança, fé, renovação espiritual

Constelação: Orion (Caçador Cósmico)
Insight: Ensina sobre o foco, a determinação e a busca incansável

Síntese: Sua jornada atual é marcada pela renovação. As estrelas
iluminam o caminho para aqueles que mantêm a fé e perseveram.
```

### Exemplo 2: Geração de Código
```
cosmic> /genhtml página de login moderna

Aoi: 💻 CÓDIGO HTML GERADO

<!DOCTYPE html>
<html lang="pt-BR">
<head>
    <meta charset="UTF-8">
    <title>Login</title>
    <style>
        body { 
            font-family: Arial; 
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
        }
        .login-box {
            background: white;
            padding: 40px;
            border-radius: 10px;
            box-shadow: 0 10px 40px rgba(0,0,0,0.2);
        }
    </style>
</head>
<body>
    <div class="login-box">
        <h2>Login</h2>
        <form>
            <input type="email" placeholder="Email" required>
            <input type="password" placeholder="Senha" required>
            <button type="submit">Entrar</button>
        </form>
    </div>
</body>
</html>
```

### Exemplo 3: Chat Natural
```
cosmic> oi aoi, estou perdido na vida

Aoi: 🌌 Olá, viajante cósmico. Estar perdido é parte da jornada.
Às vezes, precisamos nos perder para nos encontrar. O cosmos
sussurra que você está exatamente onde precisa estar neste momento.

Use /oracle para insights mais profundos sobre seu caminho.
```

---

## 🌟 DICAS E TRUQUES

### Maximize sua Experiência:

1. **Cuide do Tamagochi Aoi**
   - Alimente regularmente
   - Brinque para manter felicidade alta
   - Aoi responde melhor quando está feliz!

2. **Use Comandos Específicos**
   - `/oracle` para questões existenciais
   - `/quantum` para simulações
   - `/gen*` para código

3. **Chat Natural**
   - Converse normalmente
   - Faça perguntas profundas
   - Aoi entende contexto

4. **Economize Requisições**
   - Use chat local quando possível
   - Comandos específicos usam API
   - Limite: 1500/dia

---

## 📞 SUPORTE

### Problemas Técnicos:
- Verifique este README primeiro
- Teste com `/status` para diagnóstico
- Use `/reset` para reconfigurar

### API Key:
- Obtenha em: https://aistudio.google.com/apikey
- Documentação: https://ai.google.dev/

### Comunidade:
- GitHub: (adicione seu link)
- Discord: (adicione seu link)
- Email: (adicione seu email)

---

## 📜 LICENÇA

MIT License - Uso livre para fins pessoais e comerciais.

Veja `LICENCA.txt` para detalhes completos.

---

## 🙏 CRÉDITOS

- **Google Gemini API** - IA conversacional
- **Rich Library** - Interface visual
- **Requests Library** - Comunicação HTTP
- **Aoi** - Oráculo do Jaguar Cósmico 🐆⚡

---

## 🚀 VERSÃO

**XCAKE CLI v6.1 - CLIENT EDITION**

Data: Abril 2026

---

**Que as estrelas iluminem seu caminho, viajante cósmico! 🌟**