Skip to content

mumunha/cerebro

Repository files navigation

cerebro

Cerebro - Bot Telegram

Cerebro é um bot do Telegram que tem o objetivo de ser seu segundo cérebro por meio do processamento de linguagem natural e inteligência artificial. Ele utiliza a LLMs para interpretar entradas de voz e texto, facilitando uma experiência única para alavancar seu potencial. Ideal para criadores, escritores e qualquer pessoa que deseje explorar e expandir suas ideias, o Cérebro atua como um parceiro usando ferramenta de inteligência artificial.

Descrição

Principais Características já implementadas:

  • Processamento de entradas de voz e texto
  • Identificação e categorização de ideias
  • Sessão de brainstorming automatizada com base nas ideias identificadas
  • Armazenamento persistente de ideias e sessões para referência futura
  • Modelo de interação flexível, apoiando tanto a exploração imediata quanto adiada das ideias

Instalação

Pré-requisitos

  • Python 3.10.7 (se você tiver outra versão instalada, instale essa e selecione essa versão para o ambiente virtual)
  • Uma conta no Telegram

Configuração

  1. Copie os arquivos do projeto: Baixe os arquivos projeto para sua máquina local e salve em uma pasta ou faça o clone do repositório do GitHub usando o comando git clone.
git clone https://github.com/mumunha/cerebro.git
  1. Navegue até o Diretório do Projeto

Segue como arquivos devem estar apresentados no diretório do projeto:

estrura arquivos

  1. Configure o Ambiente Python (Opcional, mas recomendado): Use um ambiente virtual para evitar conflitos com outros projetos.

Windows:

No prompt de comando ou no terminal do vscode.

Crie o ambiente virtual:

Se você tiver várias versões do Python, use o seguinte comando (substitua USERNAME pelo seu usuário):

C:\Users\USERNAME\AppData\Local\Programs\Python\Python310\python -m venv venv
python -m venv venv

Ative o ambiente virtual Se for no vscode ou PowerShell

.\venv\Scripts\Activate.ps1

Se for no prompt de comando

.\venv\Scripts\activate.bat
  1. Instale as Dependências: Instale os requisitos do projeto.
pip install -r requirements.txt

Criando Seu Bot do Telegram com o BotFather

  1. Inicie o BotFather: No Telegram, procure pela conta do BotFather (@BotFather), o bot oficial para criar e gerenciar bots do Telegram.

  2. Crie um Novo Bot: Envie /newbot para o BotFather e siga as instruções. Você precisará fornecer um nome e um nome de usuário único para o seu bot.

  3. Obtenha o Token da API: Após a criação bem-sucedida, o BotFather fornecerá um token da API para o seu novo bot. Esse token permite que seu bot se comunique com a API do Telegram.

  4. Configuração de APIs: Renomeie secrets_cerebro.py.example para secrets_cerebro.py e preencha-o com suas chaves de API do Telegram e OpenAI conforme necessário.

Executando o Cérebro

Execute cerebro.py para iniciar o bot:

python cerebro.py

Isso ativará o Cerebro na sua conta do Telegram, pronto para receber e processar suas entradas. Da primeira vez que você tentar conversar com o Cerebro ele não identificará você. Você precisará capturar o código do usuário no terminal e inserí-lo no arquivo secrets_cerebro.py

Inicialização do Banco de Dados: A primeira execução do cerebro.py configurará automaticamente o banco de dados SQLite necessário (cerebro.db) para armazenar dados da sessão.

Uso

  • Captura de Ideias por Voz: Envie uma mensagem de voz para o Cérebro com sua ideia, e ele a processará e perguntará se você deseja fazer um brainstorming sobre essa ideia.
  • Entrada de Texto: Envie mensagens de texto para ideias rápidas ou comandos para gerenciar suas sessões de ideias.
  • Sessões de Brainstorming: Siga as instruções do bot para explorar e expandir suas ideias.

Ideias para implementação futura

  • Gestão de aniversários: Sempre esqueço de algumas datas, gostaria de ajuda pra me lembrar e eventualmente escrever mensagens personalizadas
  • Adicionar elementos às ideias existentes: Permitir ao usuário complementar elementos às ideias existentes
  • Incorporar agentes (crewAI) para realização de tarefas específicas

Contribuindo

Contribuições para o Cerebro são bem-vindas! Faça um fork do repositório e submeta um pull request com suas melhorias.

Licença

Este projeto é de código aberto sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.

About

Seu segundo cerebro

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages