Skip to content

README.md

Latest commit

 

History

History
139 lines (105 loc) · 3.4 KB

README.md

File metadata and controls

139 lines (105 loc) · 3.4 KB
Raw

🐱 GatoBot

GatoBot Logo

Discord Website

📋 Descripción

GatoBot es un bot de Discord versátil y amigable, diseñado para mejorar la experiencia de tu servidor. Con una interfaz web moderna y funciones potentes, GatoBot combina utilidad y facilidad de uso.

✨ Características

🛡️ Moderación

  • Gestión de usuarios (kick, ban, timeout)
  • Sistema de advertencias
  • Filtrado de contenido
  • Logs de acciones

🎵 Música

  • Reproducción de música de alta calidad
  • Soporte para múltiples plataformas
  • Control de cola y reproducción
  • Comandos intuitivos

🎮 Diversión

  • Comandos interactivos
  • Mini-juegos
  • Reacciones personalizadas

⚙️ Utilidades

  • Sistema avanzado de embeds
  • Anuncios personalizables
  • Información del servidor
  • Estadísticas

🚀 Uso

Comandos Principales

/help - Muestra la lista de comandos
/play - Reproduce música
/create_embed - Crea embeds personalizados
/update_announcement - Envía anuncios globales (solo desarrollador)

Ejemplos

  1. Reproducir Música

    /play <URL o nombre de la canción>

  2. Crear Embed

    /create_embed #canal

  3. Moderación

    /timeout @usuario <duración> <razón>
/warn @usuario <razón>

🛠️ Tecnologías

  • Backend: Python, Discord.py
  • Frontend: Astro, React, TailwindCSS
  • Base de Datos: SQLite
  • API: FastAPI
  • Contenedorización: Docker

📥 Instalación

  1. Clonar el repositorio

    git clone https://github.com/GatoArtStudio/GatoBot.git
cd GatoBot

  2. Configurar variables de entorno

    cp .env.example .env
# Editar .env con tus tokens y configuraciones

  3. Instalar dependencias

    pip install -r requirements.txt

  4. Iniciar el bot

    # Usando Docker
docker-compose up -d

# Sin Docker
python src/main.py

🌐 Arquitectura

GatoBot/
└── src
   ├── api/            # API REST con FastAPI
   ├── assets/         # Recursos estáticos
   ├── commands/       # Comandos del bot
   ├── config/         # Configuraciones
   ├── core/           # Núcleo del bot
   ├── database/       # Base de datos
   ├── events/         # Eventos del bot
   ├── frontend/       # Interfaz web (Astro + React)
   ├── helpers/        # Utilidades y helpers
   ├── models/         # Modelos de datos
   ├── services/       # Servicios
   └── views/          # Vistas de discord

🤝 Contribuir

Las contribuciones son bienvenidas! Por favor, lee nuestro CONTRIBUTING.md para más detalles.

📄 Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

👥 Créditos

Desarrollado con ❤️ por GatoArtStudio

📞 Soporte