🔧 Statics Solver AI

A mobile app that solves Engineering Statics problems using AI. Built with React Native and Expo.

About

Statics Solver AI helps engineering students solve statics problems by sending questions to an open-source AI model (Qwen3-235B) via Hugging Face's inference API. The AI has been shown to be correct 93% of the time on statics problems. You can view and use a website implementation of this app at: Statics and Mechanics Solver AI. If you like it this repo allows you to build and deploy it on your own personal device. From time to time you may need to change the provider or model as Hugging Face occasionally deprecates these. Note that if you change models you would then need to verify the model is smart enough to solve these problems (eg see YouTube Link). You can download the dataset from Hugging Face.

Features

• 🎯 68 Example Questions - Covers 11 topics from force vectors to moments of inertia
• ✏️ Submit Your Own Questions - Enter any statics problem in text format
• 🤖 Powered by Qwen3-235B - State-of-the-art open-source reasoning model
• 🔒 Secure API Key Storage - Your Hugging Face API key is stored locally on your device
• 📱 Cross-Platform - Works on Android and iOS

Topics Covered

1. Force vectors
2. Particle equilibrium
3. Moments
4. Rigid body equilibrium
5. Trusses
6. Frames
7. Centroids
8. Beam reactions
9. Beam internal forces
10. Friction
11. Moments of inertia

Getting Started

Prerequisites

• Node.js installed
• Expo CLI (npm install -g expo-cli)
• A free Hugging Face account and API key from https://huggingface.co/

Installation

1. Clone the repo

   git clone https://github.com/Mike-Molt/statics-solver-ai.git
   cd statics-solver-ai

2. Install dependencies

   npm install

3. Start the app

   npx expo start

4. Scan the QR code with Expo Go app on your phone

Usage

1. Open the app and enter your Hugging Face API key
2. Choose to select an example question or submit your own
3. For your own questions:
   • Use text-only format
   • State units (imperial or metric)
   • Use positive x-axis right, positive y-axis up
4. Wait for the AI to solve (may take a few minutes for complex problems)
5. View the step-by-step solution and final answer

Tech Stack

• React Native - Mobile app framework
• Expo - Development platform
• Axios - HTTP client
• Expo Secure Store - Encrypted local storage
• Hugging Face Inference API - AI model hosting
• Qwen3-235B-A22B-Thinking-2507 - Large language model

How It Works

The app sends your statics question to Hugging Face's inference API, which routes it to a provider running the Qwen3-235B model. The model "thinks" through the problem step-by-step and returns:

• 4 key solution steps
• The final answer with units
• Reaction forces (if applicable)

Streaming is used to prevent server timeouts during long calculations.

Accuracy

Based on testing, the AI correctly solves approximately 93% of statics problems. See this video for more details: YouTube Link

Privacy

• Your API key is stored locally on your device only
• Questions are sent to Hugging Face for processing but are not stored
• No personal data is collected

See Privacy Policy for full details.

License

This project is open source and available under the MIT License.

Acknowledgments

• Hugging Face for providing the inference API
• Qwen Team for the amazing open-source model
• Engineering students everywhere struggling with statics 💪

Contact

If you have questions or suggestions, feel free to open an issue or reach out.

---

⭐ If this app helped you, please consider giving it a star!