Atomic-Library

README

🤖 Atomic Library - SCA CLI

CLI para crear bots inteligentes de WhatsApp para tu negocio en minutos.

✨ Características

• 🎨 Terminal estilo GitHub - Interfaz visual azul atractiva
• 🚀 Instalación en una línea - Como npm, sin complicaciones
• 🤖 WhatsApp Web gratuito - Sin costos de API
• 🧠 IA con Gemini - Conversaciones inteligentes
• 📊 Google Sheets & Calendar - Gestión automática de citas
• 🔄 Auto-recarga - Detecta cambios en configuración
• 📦 Templates desde GitHub - Siempre actualizado
• 🌍 Multiplataforma - Linux, macOS y Windows

---

⚡ Instalación Rápida

Una línea (Recomendado)

go install github.com/attomos07/Atomic-Library@latest

Requisitos previos:

• Go 1.21 o superior instalado
• $GOPATH/bin en tu PATH

Verificar instalación

sca version
sca help

Si sca no se encuentra

Agrega $GOPATH/bin a tu PATH:

Linux/macOS (Bash):

echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.bashrc
source ~/.bashrc

Linux/macOS (Zsh):

echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell):

$goPath = go env GOPATH
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$goPath\bin", "User")

---

🚀 Uso Rápido

# 1. Crear un nuevo bot
sca create

# 2. Entrar al proyecto
cd mi-bot-whatsapp

# 3. Instalar dependencias
sca install

# 4. Configurar API Key
# Linux/macOS:
nano .env
# Windows:
notepad .env
# Agrega: GEMINI_API_KEY=tu_api_key_aqui

# 5. Ejecutar el bot
sca run
# Escanea el QR con WhatsApp

---

📝 Comandos Disponibles

sca create      # Crear un nuevo bot
sca install     # Instalar dependencias
sca run         # Ejecutar el bot
sca build       # Compilar a binario
sca clean       # Limpiar archivos generados
sca status      # Ver estado de configuración
sca help        # Mostrar ayuda
sca version     # Mostrar versión

---

🔧 Configuración

Variables de entorno (.env)

# Gemini AI (Requerido para IA)
GEMINI_API_KEY=tu_api_key_aqui

# Google Sheets (Opcional)
SPREADSHEETID=tu_spreadsheet_id

# Google Calendar (Opcional)
GOOGLE_CALENDAR_ID=tu_email@gmail.com

# Base de datos
DATABASE_FILE=whatsapp.db

# Logging
LOG_LEVEL=INFO

Obtener API Keys

1. Gemini AI: https://makersuite.google.com/app/apikey
2. Google Cloud: https://console.cloud.google.com
   • Habilita Google Sheets API
   • Habilita Google Calendar API
   • Crea Service Account
   • Descarga google.json

---

📱 Proveedores Disponibles

• ✅ WhatsApp Web (Gratuito) - Disponible ahora
• 🔜 Meta WhatsApp Business API - Próximamente
• 🔜 Telegram - Próximamente
• 🔜 Messenger - Próximamente
• 🔜 Instagram - Próximamente

🏪 Tipos de Negocio

• ✅ Barbería / Peluquería - Disponible ahora
• 🔜 Clínica Dental - Próximamente
• 🔜 Restaurante - Próximamente
• 🔜 Comercio Local - Próximamente

---

🎯 Cómo Funciona

1. sca create descarga los templates desde GitHub
2. Crea la estructura del proyecto en un nuevo directorio
3. sca install instala las dependencias Go
4. sca run ejecuta el bot y muestra el QR
5. Escaneas el QR con WhatsApp
6. ¡Tu bot está funcionando! 🎉

---

📂 Estructura del Proyecto Generado

mi-bot-whatsapp/
├── main.go              # Punto de entrada
├── src/
│   ├── app.go          # Lógica del bot
│   ├── gemini.go       # Integración IA
│   ├── sheets.go       # Google Sheets
│   ├── calendar.go     # Google Calendar
│   ├── config.go       # Configuración
│   └── utils.go        # Utilidades
├── .env.example        # Plantilla de variables
├── .gitignore
├── go.mod
└── README.md

---

🔄 Actualizar SCA CLI

go install github.com/attomos07/Atomic-Library@latest

---

🐛 Solución de Problemas

El comando sca no se encuentra

Verifica que Go esté instalado:

go version

Verifica la ubicación de binarios de Go:

go env GOPATH

Agrega al PATH (si no está):

# Linux/macOS
export PATH=$PATH:$(go env GOPATH)/bin

# Windows
# Ver instrucciones arriba

Error: "templates no encontrados"

Verifica tu conexión a internet. Los templates se descargan automáticamente desde GitHub.

Error: "go.mod no encontrado"

Asegúrate de estar en el directorio del proyecto creado con sca create.

---

💻 Requisitos del Sistema

• Go: >= 1.21
• Sistemas Operativos:
  • Linux (Ubuntu, Debian, Fedora, etc.)
  • macOS (Intel y Apple Silicon)
  • Windows 10/11
• Espacio en disco: ~50MB
• RAM: 512MB mínimo
• Internet: Para descargar templates y dependencias

---

🤝 Contribuir

Las contribuciones son bienvenidas!

1. Fork el proyecto
2. Crea una rama: git checkout -b feature/nueva-funcionalidad
3. Commit: git commit -am 'Agregar nueva funcionalidad'
4. Push: git push origin feature/nueva-funcionalidad
5. Abre un Pull Request

---

📄 Licencia

MIT License - ver LICENSE para más detalles.

---

📞 Soporte

• 🐛 Issues
• 💬 Discussions

---

⭐ Dale una estrella

Si este proyecto te ayuda, ¡considera darle una estrella en GitHub! ⭐

---

Atomic Library - Creado con ❤️ para automatizar negocios