Configuración: alertas, clave de IA y tu propia copia

Dónde están los ajustes

Abre el repositorio en GitHub → Settings → Secrets and variables → Actions. Hay dos pestañas:

• Secrets: valores ocultos (tokens, claves). Nadie puede volver a leerlos y se ocultan en los registros.
• Variables: valores normales no secretos (un código de idioma, un nombre de modelo).

Los cambios se aplican desde la siguiente ejecución. Para ejecutar ya: Actions → research-agents → Run workflow.

Alertas de Telegram

Los agentes te escriben cuando pasa algo importante: cambia el régimen del mercado, la regla H-020 entra o sale, una hipótesis recibe un nuevo veredicto, falla una fuente de datos, y una vez por semana, un resumen.

1. En Telegram abre @BotFather. Usa un bot existente (/mybots → tu bot → API Token) o crea uno con /newbot.
2. Abre tu bot y pulsa Start; si no, no puede escribirte.
3. Tu ID de chat: escribe a @userinfobot, responde con un número como 123456789. Para un grupo o canal añade allí el bot; sus ID empiezan por -100.
4. En Settings → Secrets and variables → Actions → Secrets → New repository secret crea TELEGRAM_BOT_TOKEN (el token) y TELEGRAM_CHAT_ID (el ID).
5. Idioma: en Variables → New repository variable crea TELEGRAM_LANG con es (o en, ru, pt, tr, vi, zh). Sin ella las alertas llegan en inglés. Cada alerta termina con un enlace al panel en el mismo idioma.
6. Prueba: Actions → research-agents → Run workflow, marca test_alert y ejecuta. En unos minutos llegará «las alertas de Telegram están conectadas». Si el paso falla, el token o el ID son incorrectos o el bot no se inició.

Las alertas solo llegan cuando algo cambia.

Clave de modelo de IA (opcional)

Todas las pruebas las hace el motor con reglas fijas; nunca se pregunta a un modelo si una idea funciona. Una clave de modelo añade dos ayudantes:

• Resumen semanal en palabras sencillas. Sin clave recibes los informes semanales en bruto, en inglés. Con clave, un modelo los resume en el idioma de TELEGRAM_LANG, solo con cifras de los informes y sin sugerir operaciones.
• Borradores de nuevas hipótesis cada mes (el día 1). El modelo propone ideas como pull request en estado draft. Tú decides qué registrar; nada se prueba hasta entonces.

Opción gratuita: Groq. Regístrate en console.groq.com → API Keys → Create API Key y guárdala como secreto LLM_API_KEY. No hay que pagar (el plan gratuito tiene límites diarios, de sobra para un resumen semanal). El modelo se elige automáticamente entre los modelos gratuitos que Groq ofrece en ese momento (cambian de nombre y se retiran); fija uno con CRL_LLM_MODEL. Cualquier otro servicio compatible con OpenAI (OpenRouter, Gemini) también sirve: pon su dirección en la variable CRL_LLM_BASE_URL. Si hay dos claves, se usa LLM_API_KEY.

Cómo conectar Anthropic (de pago):

1. Entra en console.anthropic.com, regístrate y añade saldo en Billing. La API se paga por uso y aparte de una suscripción de Claude; un resumen semanal y una propuesta mensual cuestan céntimos al mes. Comprueba antes que tu país está en la lista de regiones admitidas por Anthropic.
2. API Keys → Create Key y copia la clave (sk-ant-…). Solo se muestra una vez.
3. En Settings → Secrets and variables → Actions → Secrets crea ANTHROPIC_API_KEY con la clave.
4. Opcional: variable CRL_LLM_MODEL para elegir otro modelo (por defecto claude-sonnet-5-5).
5. Para que los borradores lleguen como pull requests: Settings → Actions → General → Allow GitHub Actions to create and approve pull requests.

Para desactivarla, borra el secreto. Si la clave se filtra, revócala en la consola enseguida.

Tu propia copia

Todo funciona en los servidores gratuitos de GitHub; no necesitas nada en tu ordenador.

1. Abre https://github.com/f1devbin/Crypto-Research-Labs y pulsa Fork.
2. En tu copia: Settings → Pages → Source: GitHub Actions.
3. Actions → activa los workflows si lo pide → research-agents → Run workflow. La primera ejecución tarda unos 20 minutos (descarga el historial de precios). Después funciona sola cada día.
4. Tu panel estará en https://<tu-usuario>.github.io/Crypto-Research-Labs/.
5. Si quieres, añade Telegram y la clave de IA como se explica arriba.

Para proponer tu idea, mira CONTRIBUTING.md o publícala en Discussions → Ideas.

Todos los ajustes