Documentación
Instalación, activación y flujo de trabajo (Colector → Entrenador → Predictor).
Requisitos
- Windows 10+ (x64). macOS 12+ (Apple/Intel). Linux x64 (glibc reciente).
- 4 GB RAM / 500 MB de disco (recomendado: 8 GB RAM).
- Conexión estable a Internet para APIs de exchanges.
Instalación en Windows
- Descargá el instalador desde Descargar.
- Hacé doble clic en el .exe y seguí los pasos.
- Si Windows SmartScreen muestra alerta, clic en Más información → Ejecutar de todas formas.
- Abrí TokenLens desde el menú inicio.
Instalación en macOS
Instalador .dmg próximamente. Mientras tanto, seguí estos pasos:
- Descargá el build o seguí la guía de instalación manual.
- Si Gatekeeper bloquea la app, abrí con clic derecho → Abrir.
- Permití el acceso de red cuando se solicite.
Instalación en Linux
Usá AppImage cuando esté disponible o instalación manual.
# Ejemplo AppImage
chmod +x TokenLens_Linux.AppImage
./TokenLens_Linux.AppImage
Activar licencia (.jwt)
- Tras la compra, recibís por email tu archivo license.jwt.
- Abrí la app → menú Licencia → Cargar archivo.
- Verificá que el estado muestre Licencia válida.
Pipeline de trabajo
1) Colector
- Obtiene OHLCV y métricas recientes (VWAP, volumen).
- Guarda datos locales para entrenamiento/predicción.
2) Entrenador (LSTM por token)
- Entrena modelos por símbolo con ventanas temporales.
- Genera checkpoints reutilizables.
3) Predictor
- Calcula probabilidad de entrada (ENTER).
- Emite BUY/SELL según umbrales y exporta CSV.
Tips
- Actualizar datos con Colector antes de predecir.
- Reentrenar periódicamente si cambian las condiciones.
- Ajustar umbrales para tu perfil de riesgo.
Configuración
Archivo sugerido: config/config.json.
{
"symbols": ["BTC/USDT","ETH/USDT"],
"buy_threshold": 0.72,
"sell_threshold": 0.28,
"window": 128,
"telegram": {
"enabled": false,
"bot_token": "123:ABC",
"chat_id": "123456789"
}
}
- buy_threshold: prob. mínima para BUY.
- sell_threshold: prob. máxima para SELL.
- window: tamaño de ventana para el modelo.
Alertas por Telegram (opcional)
- Creá un bot con @BotFather y obtené el BOT_TOKEN.
- Enviá un mensaje al bot para iniciar chat y obtené tu chat_id (p. ej. con @userinfobot).
- Activá en la config telegram.enabled=true y completá credenciales.
Solución de problemas
- No descarga datos: verificá conexión, proxy/VPN y límites de API.
- Licencia inválida: revisá el archivo .jwt y el reloj del sistema.
- Resultados raros: reentrená, ampliá datos y ajustá umbrales.
FAQ
¿Necesito claves de exchange?
No para generar señales. Sólo si activás un bot de ejecución (read-only y mínimos permisos).
¿Cada cuánto reentreno?
Depende del token y tu horizonte. Semanal o por evento de mercado es un buen punto de partida.
¿Dónde se guardan los CSV?
En la carpeta de trabajo definida por la app (p. ej. ./output/).
Última actualización: 2025-09-06