---
title: Bolt Torque Calculator
emoji: 📉
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 5.47.2
app_file: app.py
pinned: false
license: mit
short_description: First-principles calculation of bolt torque
---

# Bolt Torque Calculator  

**Author:** Sebastian Andreu  
**Course:** 24679 - Designing and Deploying AI/ML Systems  

This app calculates the torque required to tighten a bolt to a target preload using first-principles engineering formulas.  
The interface allows users to input or select:  
- Bolt diameter [mm]  
- Target preload [N]  
- Thread pitch [mm]  
- Bolt material and lubrication (for estimating thread friction coefficient)  
- Nut/under-head material and lubrication (for estimating friction under the head)  
- Optional head diameter [mm]  

The model outputs the required torque in **Nm** along with a natural language explanation of the result for non-experts.  

---

## How to Use  
1. Enter the bolt geometry and preload values.  
2. Select the bolt and nut/head materials and lubrication type.  
3. Optionally specify the head diameter; leave blank to use default (1.5×bolt diameter).  
4. Click **Compute** to see the torque and an easy-to-understand explanation.  

---

## Deployment Details  
- **Frameworks:** [Gradio](https://gradio.app/)  
- **Hosting:** Hugging Face Spaces  
- **Model Loading:** The LLM used for explanations is downloaded from the Hugging Face Hub on startup.  

---

## Requirements  
Dependencies are listed in `requirements.txt`.  
Includes: `gradio`, `pandas`, `transformers`  

---

## Acknowledgments  
- Torque calculation formulas based on standard ISO metric bolt theory  
- Deployment scaffold and documentation supported with AI assistance (ChatGPT, OpenAI)  
- Reference: Class-provided notebook *beam_gradio.ipynb*  

---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference