Skip to content

NOirBRight/hevy-analyzer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hevy Analyzer 🏋️‍♂️

A powerful workout data analysis tool for Hevy users. Visualize your training progress with interactive charts, muscle heatmaps, and detailed statistics.

Python Streamlit License

✨ Features

  • 📊 Interactive Charts - Visualize workouts, sets, volume, and duration over time
  • 🔥 Muscle Heatmap - See which muscle groups you're training with an anatomical SVG visualization
  • 📈 Progress Tracking - Track your strength gains and personal records
  • 🎯 Exercise Analysis - Detailed breakdown by exercise, muscle group, and equipment
  • ⚙️ Customizable - Add custom exercises and configure calculation methods
  • 🌐 API Integration - Connect directly to Hevy API or import CSV exports

🚀 Quick Start

Option 1: Run from Source

  1. Clone the repository:
git clone https://github.com/NOirBRight/hevy-analyzer.git
cd hevy-analyzer
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the app:
streamlit run app.py
  1. Open your browser to http://localhost:8501

Option 2: Windows Executable

Download the latest release from the Releases page and run HevyAnalyzer.exe.

📦 Requirements

  • Python 3.8+
  • See requirements.txt for full dependencies

🔧 Configuration

Data Sources

  1. Hevy API - Enter your Hevy API key in Settings to sync directly
  2. CSV Import - Export your data from Hevy app and upload the CSV file

Custom Exercises

Add your own exercises with muscle group mappings in the Settings page.

📸 Screenshots

Dashboard

Interactive charts showing your workout trends over time.

Muscle Heatmap

Anatomical visualization showing muscle activation frequency.

Exercise Analysis

Detailed breakdown of each exercise with volume and progression.

🛠️ Building from Source

To create a Windows executable:

pip install pyinstaller
pyinstaller HevyAnalyzer.spec --noconfirm

The executable will be in dist/HevyAnalyzer/.

📄 License

MIT License - see LICENSE for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Contact

For issues and feature requests, please use the GitHub Issues page.


Made with ❤️ for the fitness community

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors