Configuração: alertas, chave de IA e sua própria cópia

Onde ficam as configurações

Abra o repositório no GitHub → Settings → Secrets and variables → Actions. Há duas abas:

• Secrets: valores ocultos (tokens, chaves). Ninguém consegue lê-los de volta e eles ficam mascarados nos logs.
• Variables: valores comuns, não secretos (um código de idioma, um nome de modelo).

As mudanças valem a partir da próxima execução. Para rodar agora: Actions → research-agents → Run workflow.

Alertas no Telegram

Os agentes avisam quando algo importante acontece: o regime do mercado muda, a regra H-020 entra ou sai, uma hipótese recebe novo veredicto, uma fonte de dados falha, e uma vez por semana, um resumo.

1. No Telegram abra @BotFather. Use um bot existente (/mybots → seu bot → API Token) ou crie um com /newbot.
2. Abra seu bot e toque em Start; sem isso ele não pode escrever para você.
3. Seu ID: escreva para @userinfobot, ele responde com um número como 123456789. Para grupo ou canal, adicione o bot lá; os IDs começam com -100.
4. Em Settings → Secrets and variables → Actions → Secrets → New repository secret crie TELEGRAM_BOT_TOKEN (o token) e TELEGRAM_CHAT_ID (o ID).
5. Idioma: em Variables → New repository variable crie TELEGRAM_LANG com pt (ou en, ru, es, tr, vi, zh). Sem ela os alertas vêm em inglês. Cada alerta termina com um link para o painel no mesmo idioma.
6. Teste: Actions → research-agents → Run workflow, marque test_alert e execute. Em poucos minutos chega "os alertas do Telegram estão conectados". Se o passo falhar, o token ou o ID estão errados ou o bot não foi iniciado.

Os alertas só chegam quando algo muda.

Chave de modelo de IA (opcional)

Todos os testes são feitos pelo motor com regras fixas; nunca se pergunta a um modelo se uma ideia funciona. Uma chave de modelo adiciona dois ajudantes:

• Resumo semanal em palavras simples. Sem chave você recebe os relatórios brutos em inglês. Com chave, um modelo os resume no idioma de TELEGRAM_LANG, só com números dos relatórios e sem sugerir operações.
• Rascunhos de novas hipóteses todo mês (dia 1). O modelo propõe ideias como pull request com status draft. Você decide o que registrar; nada é testado antes disso.

Opção gratuita: Groq. Cadastre-se em console.groq.com → API Keys → Create API Key e salve como segredo LLM_API_KEY. Não precisa pagar (o plano gratuito tem limites diários, mais que suficientes para um resumo semanal). O modelo é escolhido automaticamente entre os modelos gratuitos que a Groq oferece no momento (eles mudam de nome e são retirados); fixe um com CRL_LLM_MODEL. Qualquer outro serviço compatível com OpenAI (OpenRouter, Gemini) também funciona: coloque o endereço na variável CRL_LLM_BASE_URL. Com as duas chaves, usa-se LLM_API_KEY.

Como conectar a Anthropic (pago):

1. Acesse console.anthropic.com, cadastre-se e adicione crédito em Billing. A API é paga por uso e separada de uma assinatura do Claude; um resumo semanal e uma proposta mensal custam centavos por mês. Verifique antes se o seu país está na lista de regiões suportadas pela Anthropic.
2. API Keys → Create Key e copie a chave (sk-ant-…). Ela aparece só uma vez.
3. Em Settings → Secrets and variables → Actions → Secrets crie ANTHROPIC_API_KEY com a chave.
4. Opcional: variável CRL_LLM_MODEL para outro modelo (padrão claude-sonnet-5-5).
5. Para os rascunhos chegarem como pull requests: Settings → Actions → General → Allow GitHub Actions to create and approve pull requests.

Para desligar, apague o segredo. Se a chave vazar, revogue-a no console imediatamente.

Sua própria cópia

Tudo roda nos servidores gratuitos do GitHub; nada é necessário no seu computador.

1. Abra https://github.com/f1devbin/Crypto-Research-Labs e clique em Fork.
2. Na sua cópia: Settings → Pages → Source: GitHub Actions.
3. Actions → ative os workflows se pedir → research-agents → Run workflow. A primeira execução leva uns 20 minutos (baixa o histórico de preços). Depois roda sozinha todo dia.
4. Seu painel fica em https://<seu-usuario>.github.io/Crypto-Research-Labs/.
5. Se quiser, adicione Telegram e a chave de IA como descrito acima.

Para sugerir uma ideia, veja CONTRIBUTING.md ou publique em Discussions → Ideas.

Todas as configurações