TTBT1 Framework

TTBT1 es un framework modular y extensible para bots, enfocado en evasión, rotación de proxies/fingerprints, CI, logging profesional, plugins, dashboard web y Docker.

---

---

Tabla de contenidos

• Instalación
• Estructura del Proyecto
• Configuración
• Ejemplo de uso básico
• Ejemplo avanzado de bot
• Plugins
• Dashboard web
• Logging avanzado
• Integración CI
• Dockerización
• Diagramas de arquitectura
• Herramientas y servicios recomendados
• Licencia

---

Instalación

git clone https://github.com/tuusuario/ttbt1.git
cd ttbt1
pip install -r requirements.txt

Dockerización

docker build -t ttbt1 .
docker run --rm -it -v $(pwd)/accounts.json:/app/accounts.json ttbt1

Estructura del Proyecto

core/               # Núcleo del framework
proxies/            # Gestión de proxies
fingerprints/       # Gestión de fingerprints
data/               # Carga de datos adicionales
bots/               # Bots personalizados y avanzados
plugins/            # Plugins externos
dashboard/          # Dashboard web Flask
logs/               # Archivos de logs
tests/              # Pruebas unitarias e integración
docs/               # Diagramas, imágenes y documentación extendida
.github/workflows/  # Integración continua (CI)

Configuración

Consulta la Guía de configuración.

---

Ejemplo de uso básico

from bots.sample_bot import SampleBot

bot = SampleBot("usuario1", {"pass": "secreta"})
bot.assign_proxy("proxyX")
bot.assign_fingerprint("fpY")
bot.run()

---

Ejemplo avanzado de bot

from bots.advanced_bot import AdvancedBot

bot = AdvancedBot("usuario1", {"pass": "supersecreta"})
bot.assign_proxy("proxyZ")
bot.assign_fingerprint("fpMega")
bot.run()

---

Plugins

El sistema de plugins permite extender el comportamiento de los bots sin tocar el core.

Ejemplo de plugin:

# plugins/logger_plugin.py
def after_login(bot):
    bot.logger.info(f"[PLUGIN] {bot.username} pasó after_login")

Carga en el bot:

self.plugin_manager.load_plugin("plugins/logger_plugin.py")

---

Dashboard web

Levanta un dashboard con Flask para monitorear bots en tiempo real.

cd dashboard
python app.py

Accede a http://localhost:5000

---

Logging avanzado

Integración con loguru para logs rotativos y estructurados.

from core.logger import get_logger
logger = get_logger("mi-bot")
logger.info("¡Bot iniciado!")

---

Integración CI

Incluye GitHub Actions para tests automáticos con pytest.

---

Diagramas de arquitectura

General

Flujo del bot

---

Herramientas y servicios recomendados

• Logging avanzado: Loguru, Sentry
• Dashboard: Flask
• Proxies premium: BrightData, Oxylabs
• Fingerprints: FingerprintJS
• Documentación: MkDocs, Read the Docs
• CI/CD: GitHub Actions
• Monitoreo: Grafana
• Diagramas: Imagine Explainers

---

Licencia

MIT. Ver LICENSE.