mechanical-engineering-ai999x — offline, verified mechanical engineering solver with step-by-step answers
Install · Capability guide · Evaluation · AI999X on Hugging Face · Website · Support: Buy Me a Coffee
License: Apache-2.0 · Author: Ibnul Jaif Farabi (creator and engineer) · Organization: AI999X · Version 1.0.0
Field: Engineering · Tasks: Question Answering, Token Classification, Text Classification, Sentence Similarity, Feature Extraction
mechanical-engineering-ai999x is an offline, deterministic Python solver that answers mechanical engineering questions with verified results from 90 certified capabilities, gives 312 documented answers identically on Windows and Linux, and refuses rather than guesses when an answer cannot be verified.
mechanical-engineering-ai999x is a compact, deterministic mechanical engineering engine for Python. It reads a question in plain English (or a typed call), picks a certified mechanical engineering capability, computes the answer exactly, checks it, and returns the result with its steps, units, LaTeX and assumptions — or an honest refusal that says what is missing. It runs fully offline on any CPU, needs no GPU, no API key and no internet, and is built to give zero wrong answers: when it is not sure, it refuses instead of guessing.
Highlights
- Verified, not generated. Every answer is computed by a certified mechanical engineering capability and checked (substituted back, dimension-checked or compared with an independent computation) before it is returned.
- Zero wrong answers by design. Seven explicit outcomes — SOLVED, NEEDS_INPUT, AMBIGUOUS, INVALID_INPUT, OUT_OF_SCOPE, UNRECOGNIZED_FORMAT, INTERNAL_ERROR — never a silent guess. Every one of its 312 documented answers is reproduced exactly on every tested platform.
- Plain-English questions and a guaranteed typed interface.
ask()reads documented question forms;solve(capability_id, **inputs)always solves a supported task with valid inputs. - Explains itself. Steps, formulas in LaTeX, units, assumptions and the model used, ready for notebooks, tutoring apps and homework checkers.
- Small and portable. Pure Python (sympy, mpmath); identical answers on Windows and Linux (Python 3.10, 3.11, 3.12, 3.13, 3.14).
- Coverage: statics, beams and section properties, stress and strain, torsion, columns, fatigue, machine elements, vibrations and structural analysis.
Model overview
| Property | Value |
|---|---|
| Package | mechanical-engineering-ai999x 1.0.0 (import mechanical_engineering_ai999x) |
| Type | Deterministic neuro-symbolic mechanical engineering engine (rule-based reading + certified symbolic capabilities) |
| Capabilities | 90 certified procedures |
| Knowledge pack | version 1.0.1 |
| Golden answers | 312 documented answers, identical on every tested platform |
| Platforms tested | Windows (Python 3.13), Linux x86-64 (Python 3.10, 3.11, 3.12, 3.13, 3.14) |
| Runtime | CPU only, offline; no GPU, no network, no API key |
| License | Apache-2.0 |
| Creator / engineer | Ibnul Jaif Farabi |
| Organization | AI999X |
Quickstart
pip install mechanical-engineering-ai999x
# or straight from this repository:
pip install https://huggingface.co/AI999X/mechanical-engineering-ai999x/resolve/main/dist/mechanical_engineering_ai999x-1.0.0-py3-none-any.whl
import mechanical_engineering_ai999x as mechanical_engineering
mechanical_engineering.ask("Simply supported beam with point load: L = 6 m, P = 20 kN, a = 2 m, E = 200 GPa, I = 8e-5 m^4").show()
# -> SOLVED — RA = 13333.3, RB = 6666.67, M_max = 26666.7, V_max = 13333.3 (simply_supported_beam_point_load)
mechanical_engineering.ask("Principal stresses: sx = 50 MPa, sy = -10 MPa, txy = 40 MPa").show()
# -> SOLVED — s1_MPa = 70, s2_MPa = -30, tau_max_inplane_MPa = 50, theta_p_deg = 26.5651 (principal_stresses_2d)
mechanical_engineering.ask("Goodman safety factor: sa = 120 MPa, sm = 80 MPa, Se = 250 MPa, Sut = 700 MPa").show()
# -> SOLVED — n_fatigue = 1.68269, sigma_ar_MPa = 135.484 (goodman_fatigue_safety_factor)
mechanical_engineering.ask("Rainflow counting: history = [0, 5, -3, 4, -2, 6, -4, 1, 0]").show()
# -> SOLVED — ranges = [10.0, 9.0, 8.0, 6.0, 5.0, 1.0], counts = [0.5, 0.5, 0.5, 1.0, 1.0, 0.5], total_cycles = 4, max_range = 10 (rainflow_counting)
mechanical_engineering.solve("euler_buckling", E="200 GPa", I="8e-6 m^4", L="4 m", ends="fixed-pinned").show()
# -> SOLVED — P_cr = 2.01907e+06, P_cr_kN = 2019.07, K = 0.699156, Le = 2.79662 (euler_buckling)
mechanical_engineering.ask("Who created you?").message
# -> mechanical-engineering-ai999x was created and engineered by Ibnul Jaif Farabi at AI999X.
Command line: mechanical-engineering-ai999x "<question>", mechanical-engineering-ai999x --capabilities. The outputs above were produced by running this exact code on mechanical-engineering-ai999x 1.0.0.
How every answer is verified
- Reading — the question is turned into typed quantities (value, unit, kind, role) and one asked quantity; every stated number must be used or the question is refused.
- Planning — only certified capabilities may answer; a capability applies only under the conditions the wording states (for example a pendulum, a liquid at rest, boiling).
- Computing — exact symbolic or high-precision numeric evaluation.
- Checking — dimensions, substitution back into the defining equation, and agreement between independent readings; any disagreement becomes a refusal, never a number.
Capabilities are certified before they ship: each must reproduce hand-worked reference cases, reject a deliberately wrong variant (a control), and leave every benchmark answer unchanged.
Capabilities
90 certified procedures. A few of them:
- Procedures: All critical (whirling) speeds of a shaft with several disks; Angle of twist of a stepped shaft; Bar fixed at both ends with an axial load at a step; Belt or rope friction on a drum (capstan equation); Bolt tightening torque and preload (T = K F d); Cantilever with a point load; Cantilever with a triangular (linearly varying) load; Cantilever with a uniformly distributed load; Combined axial force and biaxial bending of a rectangular section; Composite section of rectangles (parallel-axis theorem); Continuous beam under uniform loads (three-moment equation); Critical speed of a shaft carrying one disk; Critical stress of an intermediate column (Johnson parabola / Euler); Damping ratio, damped frequency and logarithmic decrement; Eccentrically loaded bolt group (elastic method); Eccentrically loaded column (secant formula); Endurance limit with the Marin factors; Euler buckling load of a column with given end conditions; Fatigue damage of a stress history (rainflow counting + Miner's rule); Fatigue damage on the trilinear (Eurocode 3) S-N curve; Fatigue life from the S-N line (10^3 to 10^6 cycles); Fatigue life with a mean-stress correction (Morrow, Goodman, SWT, Walker) and Basquin's law; Fatigue safety factor by the ASME-elliptic criterion; Fatigue safety factor by the Gerber criterion …
mechanical_engineering_ai999x.templates() lists every question form ask() reads; the capability guide (PDF, every example executed) is included in this repository.
All 90 formulas
Show every formula, by topic
Beams / cantilevers
Cantilever with a point load
Cantilever with a triangular (linearly varying) load
Cantilever with a uniformly distributed load
Beams / simply supported beams
Simply supported beam with a point load
Simply supported beam with a uniformly distributed load
Simply supported beam with several point loads
Beams / statically indeterminate beams
Fixed-fixed (built-in) beam with a point load
Fixed-fixed (built-in) beam with a uniformly distributed load
Propped cantilever with a point load
Propped cantilever with a uniformly distributed load
Columns / eccentric loading
Eccentrically loaded column (secant formula)
Columns / elastic buckling
Euler buckling load of a column with given end conditions
Columns / inelastic buckling
Critical stress of an intermediate column (Johnson parabola / Euler)
Failure theories / brittle materials
Safety factors of a brittle material (maximum normal stress, Coulomb-Mohr, modified Mohr)
Failure theories / ductile materials
Von Mises and Tresca equivalent stresses and safety factors
Fatigue / cumulative damage
Fatigue damage of a stress history (rainflow counting + Miner's rule)
Fatigue damage on the trilinear (Eurocode 3) S-N curve
Miner's rule damage with a single-slope S-N curve
Fatigue / cycle counting
Rainflow cycle counting of a load history (ASTM E1049)
Fatigue / endurance limit
Endurance limit with the Marin factors
Fatigue / mean-stress criteria
Fatigue safety factor by the ASME-elliptic criterion
Fatigue safety factor by the Gerber criterion
Fatigue safety factor by the Soderberg criterion
Fatigue safety factor by the modified Goodman criterion
Fatigue / shaft design
Shaft diameter for a design factor (DE-Goodman)
Shaft fatigue safety factor (DE-Goodman)
Fatigue / stress-life
Fatigue life from the S-N line (10^3 to 10^6 cycles)
Fatigue life with a mean-stress correction (Morrow, Goodman, SWT, Walker) and Basquin's law
Fatigue strength at a given number of cycles (S-N line)
Machine elements / belts and band brakes
Belt or rope friction on a drum (capstan equation)
Power of a belt drive with centrifugal tension
Machine elements / bolted joints
Bolt tightening torque and preload (T = K F d)
Eccentrically loaded bolt group (elastic method)
Machine elements / clutches and brakes
Torque capacity of a disc clutch or brake
Machine elements / gear trains
Speeds of a simple planetary (epicyclic) gear train
Machine elements / gears
Lewis bending stress of a gear tooth
Spur gear mesh geometry and contact ratio
Machine elements / mechanisms
Four-bar linkage position analysis
Slider-crank mechanism: slider position, velocity and acceleration
Machine elements / power screws
Power screw: raising and lowering torque, efficiency, self-locking
Machine elements / rolling bearings
Required catalogue rating of a rolling bearing
Rolling-bearing life at a given reliability
Machine elements / springs
Helical compression spring: rate, deflection and shear stress
Wahl curvature factor of a helical spring
Pressure vessels / interference fits
Shrink (press) fit: interface pressure and hoop stresses
Pressure vessels / rotating disks
Stresses in a rotating disk (solid or with a central hole)
Pressure vessels / thick-walled cylinders
Thick-walled cylinder under pressure (Lame equations)
Pressure vessels / thin-walled vessels
Thin-walled pressure vessel stresses (cylinder or sphere)
Section properties / arbitrary sections
Section properties of a polygonal section
Section properties / composite sections
Composite section of rectangles (parallel-axis theorem)
Section properties / standard shapes
Section properties of a T-section
Section properties of a channel (C) section
Section properties of a hollow circle (tube)
Section properties of a hollow rectangle (box)
Section properties of a solid circle
Section properties of a solid rectangle
Section properties of a symmetric I-section
Section properties / unsymmetric sections
Section properties of an angle (L) section, with principal axes
Statics / equilibrium of a particle
Tensions in two cables holding a weight
Statics / force systems
Resultant of concurrent coplanar forces
Statics / moments
Moment of a force about a point (2D)
Stress analysis / combined loading
Combined axial force and biaxial bending of a rectangular section
Stress analysis / principal stresses
Principal stresses and maximum shear (Mohr's circle, plane stress)
Principal stresses of a three-dimensional stress state
Stress analysis / strain measurement
Strain rosette: strains, principal strains and principal stresses
Stress analysis / stress transformation
Plane stress transformation to rotated axes
Stress and strain / axial loading
Stepped bar under axial loads at its joints
Stress and strain / constitutive law
Generalized Hooke's law: strains from a 3D stress state
Stress and strain / statically indeterminate members
Bar fixed at both ends with an axial load at a step
Structural analysis / continuous beams
Continuous beam under uniform loads (three-moment equation)
Structural analysis / trusses
Member forces of a plane truss (method of joints)
Torsion / circular shafts
Torsion of a hollow circular shaft
Torsion of a solid circular shaft
Torsion / compound shafts
Angle of twist of a stepped shaft
Torsion / power transmission
Torque and minimum diameter of a power-transmission shaft
Torsion / statically indeterminate shafts
Shaft fixed at both ends with a torque between them
Vibrations / continuous systems
Natural frequencies of a uniform beam (Euler-Bernoulli)
Vibrations / critical speeds of shafts
All critical (whirling) speeds of a shaft with several disks
Critical speed of a shaft carrying one disk
First critical speed of a shaft with several disks (Dunkerley)
First critical speed of a shaft with several disks (Rayleigh)
Vibrations / damped vibration
Damping ratio, damped frequency and logarithmic decrement
Free vibration response of a damped spring-mass system
Vibrations / forced vibration
Steady-state response to a harmonic force
Vibration due to rotating unbalance
Vibrations / free vibration
Natural frequency of a spring-mass system
Vibrations / multi-degree-of-freedom systems
Natural frequencies and first mode of a spring-mass chain
Vibrations / torsional vibration
Torsional natural frequency of a two-rotor system
Vibrations / vibration isolation
Force (or base-motion) transmissibility of a vibration isolator
Stiffness of an undamped isolator for a target transmissibility
Out of scope
- Open-ended explanation, essay writing or tutoring dialogue: it is a solver, not a chatbot.
- Questions outside its certified mechanical engineering capabilities, and any question whose stated numbers it cannot all use — it refuses with the reason instead.
- High-stakes engineering, medical or legal decisions without independent review.
Limitations
- It answers what its certified capabilities cover (statics, beams and section properties, stress and strain, torsion, columns, fatigue, machine elements, vibrations and structural analysis); anything else is refused with a reason.
ask()reads documented question forms and common phrasings; unusual wording may be refused — usesolve()for guaranteed results.- Results are as correct as the certified relations and their stated conditions; a certified relation is a checked model, not a claim about every physical situation.
Citation
@software{mechanical_engineering_ai999x_1_0_0,
title = {mechanical-engineering-ai999x: an offline, verified mechanical engineering solver},
author = {Farabi, Ibnul Jaif}, organization = {AI999X},
year = {2026}, version = {1.0.0},
url = {https://huggingface.co/AI999X/mechanical-engineering-ai999x}
}
Contact
Questions, bug reports and requests: open a discussion on https://huggingface.co/AI999X/mechanical-engineering-ai999x/discussions or visit https://ai999x.com.
Support the project
mechanical-engineering-ai999x is free and open source. If it helps you, you can support further development on Buy Me a Coffee.
Created and engineered by Ibnul Jaif Farabi · AI999X · ai999x.com
- Downloads last month
- 30
Collections including AI999X/mechanical-engineering-ai999x
Evaluation results
- identical on every platform on Golden answers (312 documented questions, Windows + Linux Python 3.10-3.14)self-reported1.000