MonicaAgentIA/README.md

Mônica - Agente de IA Companheira

Sistema de agente de IA via Telegram que se comporta como uma companheira pessoal, conversando, cooperando e mantendo contexto contínuo com o usuário.

Estrutura

app/
├── monica_agent.py          # Código principal do agente
├── iniciar.sh               # Script de instalação e execução
├── requirements.txt         # Dependências Python
├── .env                     # Configurações locais (não comitar)
├── .env.example             # Exemplo de configuração
├── user_profile.json        # Perfil do usuário
├── contexts/                # Históricos de conversa por data
│   └── YYYY-MM-DD.json
├── README.md
└── LICENSE

Pré-requisitos

• Python 3.9+
• Conta no Telegram com bot criado via @BotFather
• Pelo menos uma chave de API de IA suportada

Configuração

1. Copie .env.example para .env e preencha:

   • TELEGRAM_BOT_TOKEN — token do bot do Telegram
   • TELEGRAM_CHAT_ID — seu chat ID no Telegram
   • OPENROUTER_API_KEY ou outra chave de API compatível

2. Ajuste intervalos se desejar:

   • MIN_INTERVAL_MINUTES
   • MAX_INTERVAL_MINUTES

Instalação e execução

cd app
chmod +x iniciar.sh
./iniciar.sh

O script cria o ambiente virtual, instala dependências e inicia o agente.

Funcionalidades

• Onboarding inicial com perguntas para construir o perfil
• Histórico de conversa por dia em contexts/
• Perfil do usuário persistido em user_profile.json
• Mensagens proativas em intervalos aleatórios configuráveis
• Suporte a múltiplos provedores de IA:
  • OpenRouter
  • StepFun
  • QwenCloud
  • llama.cpp (local)
• Atualização dinâmica do perfil via comandos naturais no chat

Comandos disponíveis

• /start — inicia ou reinicia a conversa
• /ajuda ou /help — exibe ajuda
• /perfil — mostra o perfil atual
• /reset — reseta o perfil
• /onboarding — reinicia o onboarding

Atualizando o perfil durante a conversa

Você pode atualizar seu perfil a qualquer momento usando frases como:

• Inclua isso no meu profile: ...
• Anote no meu perfil: ...
• Adicione no meu perfil: ...
• Salve no meu perfil: ...

Licença

Uso proprietário. Veja o arquivo LICENSE.