Skip to content

felipeassiss/HyroxPlanner

Repository files navigation

HyroxPlanner Logo

HyroxPlanner 🏋️‍♂️📊


Python Groq License


O HyroxPlanner é um sistema de linha de comando CLI, desenvolvido em Python, criado para auxiliar no cadastro, visualização e organização de treinos HYROX, competições e simulações.

Além das funcionalidades tradicionais de gerenciamento de treinos, o projeto também conta com um assistente inteligente integrado à API da Groq, permitindo análises e respostas contextuais com base no histórico de treinos registrado.


🚀 Funcionalidades

🏋️ Domínio de Treinos (CRUD)

  • Cadastrar novos treinos com nome, tipo, data, duração e intensidade
  • Listar todos os treinos registrados
  • Buscar treinos específicos pelo nome
  • Editar dados de um treino existente
  • Excluir treinos do registro

🏆 Domínio de Competições

  • Cadastrar novas competições com nome, data e local
  • Visualizar competições cadastradas
  • Exibir contagem regressiva automática de dias até o evento

🤖 Assistente Inteligente com IA

  • Integração com a API da Groq
  • Uso de LLM para interpretar dados do histórico de treinos
  • Respostas contextuais sobre desempenho, registros e evolução dos treinos

💻 Tecnologias e Bibliotecas Utilizadas

  • Python 3
  • Groq API
  • python-dotenv
  • Bibliotecas nativas:
    • csv
    • os
    • datetime

📁 Estrutura do Projeto

O código está organizado por domínios de negócio, facilitando a manutenção, leitura e evolução do projeto.

HyroxPlanner/
│
├── treinos.py          # Gerenciamento dos treinos
├── competicoes.py      # Gerenciamento das competições
├── agente_ia.py        # Integração com o assistente inteligente
├── utils.py            # Funções auxiliares
├── config.py           # Configurações globais
├── menu.py             # Interface de navegação
├── main.py             # Ponto de entrada do sistema
│
├── treinos.csv         # Base local de treinos
└── competicoes.txt     # Base local de competições

👥 Contribuidores

Breno Montenegro Bryan Martins Felipe Assis Gabriel Cassemiro Gabriel Feitosa João Pedro Karla



⚙️ Como rodar o projeto

OBS: É NECESSÁRIO TER O git E O python INSTALADOS NA SUA MÁQUINA.

1. Primeira vez (Instalação e Configuração)

Clonar o repositório:

git clone https://github.com/felipeassiss/HyroxPlanner

Entrar na pasta

cd HyroxPlanner

Atualizar o projeto

git pull

Após fazer alterações

git add .
git commit -m "descrição das alterações"
git push

Após já ter clonado

Atualizar o projeto

git pull

Após fazer alterações

git add .
git commit -m "descrição das alterações"
git push

About

HyroxPlanner is a training management application developed using Python that transforms Hyrox race preparation into an organized and trackable process. The project allows users to schedule weekly workouts, log running intervals, and monitor performance across the eight functional fitness stations to track their overall progress.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors