nuclear-engineering-ai999x — offline, verified nuclear 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
nuclear-engineering-ai999x is an offline, deterministic Python solver that answers nuclear engineering questions with verified results from 83 certified capabilities, gives 554 documented answers identically on Windows and Linux, and refuses rather than guesses when an answer cannot be verified.
nuclear-engineering-ai999x is a compact, deterministic nuclear engineering engine for Python. It reads a question in plain English (or a typed call), picks a certified nuclear 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 nuclear 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 554 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: radioactive decay chains and activity, radiation shielding and dosimetry, detectors and counting, neutron physics, reactor criticality and kinetics, fission-product poisons, fuel depletion and enrichment, and fuel-rod heat transfer.
Model overview
| Property | Value |
|---|---|
| Package | nuclear-engineering-ai999x 1.0.0 (import nuclear_engineering_ai999x) |
| Type | Deterministic neuro-symbolic nuclear engineering engine (rule-based reading + certified symbolic capabilities) |
| Capabilities | 83 certified procedures |
| Knowledge pack | version 1.0.1 |
| Golden answers | 554 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 nuclear-engineering-ai999x
# or straight from this repository:
pip install https://huggingface.co/AI999X/nuclear-engineering-ai999x/resolve/main/dist/nuclear_engineering_ai999x-1.0.0-py3-none-any.whl
import nuclear_engineering_ai999x as nuclear_engineering
nuclear_engineering.ask("Specific activity: nuclide = Co-60, m = 1 g").show()
# -> SOLVED — A = 4.18689e+13, A_Ci = 1131.59, a = 4.18689e+16, a_Ci_per_g = 1131.59 (nuc_specific_activity)
nuclear_engineering.ask("Point source dose rate: Gamma = 0.351 uSv*m^2/(MBq*h), A = 10 Ci, r = 2 m, mu = 0.0656 1/cm, x = 10 cm, buildup = linear").show()
# -> SOLVED — H_dot = 7.75014e-06, H_uSv_h = 27900.5, B = 1.656, T = 0.859336 (nuc_point_source_dose_rate)
nuclear_engineering.ask("Critical sphere: D = 0.9 cm, Sigma_a = 0.15 1/cm, nuSigma_f = 0.18 1/cm, extrapolation = 2.13D").show()
# -> SOLVED — R = 0.152891, R_ext = 0.172072, V = 0.0149705 (nuc_critical_sphere)
nuclear_engineering.ask("Xenon after shutdown: Sigma_f = 0.1 1/cm, phi = 3e13 1/(cm^2*s), gamma_I = 0.0639, gamma_X = 0.00237, sigma_X = 2.65e6 b, t = 10 h").show()
# -> SOLVED — X = 3.72338e+21, ratio = 1.88343, t_peak = 30167, peak_ratio = 1.90155 (nuc_xenon_after_shutdown)
nuclear_engineering.solve("nuc_enrichment_swu", x_p=0.045, x_f=0.00711, x_w=0.0025, P="1 kg").show()
# -> SOLVED — F = 9.21909, W = 8.21909, SWU = 6.87111, F_per_P = 9.21909 (nuc_enrichment_swu)
nuclear_engineering.ask("Who created you?").message
# -> nuclear-engineering-ai999x was created and engineered by Ibnul Jaif Farabi at AI999X.
Command line: nuclear-engineering-ai999x "<question>", nuclear-engineering-ai999x --capabilities. The outputs above were produced by running this exact code on nuclear-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
83 certified procedures. A few of them:
- Procedures: Activation with target depletion and product burn-up; Activity and specific activity of a mass of a radionuclide; Activity of a radionuclide and its progeny after a decay time; Approach to criticality: inverse multiplication (1/M) extrapolation; Average logarithmic energy decrement and mean scattering cosine; Average number of collisions to slow a neutron down; Committed effective dose from a dose coefficient; Committed equivalent dose to an organ from an intake (retention compartments); Compton edge and backscatter peak of a gamma line; Coolant temperature along a channel with a chopped-cosine power shape; Counting time for a target precision of the net count rate; Counts recorded from a decaying source (decay during counting); Critical radius of a bare cylindrical reactor of given height (one group); Critical radius of a bare spherical reactor (one group); Critical thickness of a bare slab reactor (one group); Critical thickness of a reflected slab reactor and reflector savings (one group); Critical third side of a bare rectangular reactor (one group); Currie critical level, detection limit and minimum detectable activity; Dead-time correction, non-paralyzable detector; Dead-time correction, paralyzable detector; Decay heat after shutdown (Way-Wigner); Decay heat energy released between two times after shutdown; Diffusion length from an exponential pile measurement; Dose accumulated near a decaying source …
nuclear_engineering_ai999x.templates() lists every question form ask() reads; the capability guide (PDF, every example executed) is included in this repository.
All 83 formulas
Show every formula, by topic
Decay and activity / decay chains
Three-member decay chain with initial activities (Bateman)
Decay and activity / decay chains and equilibrium
Time of maximum daughter activity
Transient and secular equilibrium: activity ratio and approach
Decay and activity / decay chains of real nuclides
Activity of a radionuclide and its progeny after a decay time
Decay and activity / generators
Radionuclide generator: daughter activity after elution (with branching)
Decay and activity / neutron activation
Activation with target depletion and product burn-up
Irradiation time to reach a fraction of saturation activity
Neutron activation: activity after irradiation and decay
Decay and activity / specific activity
Activity and specific activity of a mass of a radionuclide
Mass and number of atoms of a radionuclide with a given activity
Detectors and counting / activation foils
Neutron flux from a measured foil activation
Detectors and counting / counting statistics
Counting time for a target precision of the net count rate
Optimal division of counting time between sample and background
Detectors and counting / dead time
Dead-time correction, non-paralyzable detector
Dead-time correction, paralyzable detector
Detectors and counting / decay corrections
Counts recorded from a decaying source (decay during counting)
Detectors and counting / decay-curve analysis
Half-life from a measured decay curve (weighted log-linear fit)
Two-component decay curve: amplitudes of two known half-lives
Detectors and counting / detection limits
Currie critical level, detection limit and minimum detectable activity
Detectors and counting / efficiency
Expected count rate from a point source on a detector's axis
Total and intrinsic efficiency of a slab detector for a point source on axis
Detectors and counting / gamma spectra
Compton edge and backscatter peak of a gamma line
Detectors and counting / gamma spectroscopy
Single and double escape peaks of a gamma ray
Detectors and counting / geometry
Solid angle and geometric efficiency of a disk detector (source on axis)
Solid angle of a disk detector for an off-axis point source
Dosimetry / effective dose
Effective dose from organ equivalent doses and tissue weighting factors
Dosimetry / internal dose
Committed effective dose from a dose coefficient
Dosimetry / internal emitters
Committed equivalent dose to an organ from an intake (retention compartments)
Effective half-life (physical and biological removal)
Dosimetry / units
Radiation unit conversion (Bq and Ci, Gy and rad, Sv and rem)
Fuel cycle / enrichment
Uranium enrichment: feed, tails and separative work (SWU)
Neutron physics / cross sections
Maxwellian-averaged 1/v cross section
Number densities and macroscopic cross sections of UO2 fuel
Neutron physics / diffusion
Diffusion length from an exponential pile measurement
Flux from a plane neutron source at the centre of a slab
Flux from a point neutron source at the centre of a sphere
Thermal diffusion length and migration length
Neutron physics / moderation
Average logarithmic energy decrement and mean scattering cosine
Average number of collisions to slow a neutron down
Moderating power and ratio of a compound moderator
Neutron energy and lab angle after an elastic collision
Neutron physics / thermal neutrons
Speeds and mean energy of thermal neutrons (Maxwell distribution)
Reactor kinetics / control rods
Integral and differential control-rod worth (sine-squared weighting)
Reactor kinetics / inhour equation
Reactivity from a measured stable period or doubling time (inhour)
Stable period and prompt root of the inhour equation (six delayed groups)
Reactor kinetics / point kinetics
Power after a reactivity step (one delayed group, exact)
Power after a reactivity step (six delayed groups, exact)
Stable reactor period after a reactivity step (one delayed group)
Reactor physics / approach to criticality
Approach to criticality: inverse multiplication (1/M) extrapolation
Reactor physics / criticality of bare reactors
Critical radius of a bare cylindrical reactor of given height (one group)
Critical radius of a bare spherical reactor (one group)
Critical thickness of a bare slab reactor (one group)
Critical third side of a bare rectangular reactor (one group)
Minimum-volume critical bare cylinder (one group)
k-effective and geometric buckling of a bare reactor (one group)
Reactor physics / decay heat
Decay heat after shutdown (Way-Wigner)
Decay heat energy released between two times after shutdown
Reactor physics / fission-product poisons
Equilibrium iodine-135 and xenon-135 concentrations
Samarium-149 poisoning: equilibrium and after shutdown
Xenon-135 after shutdown: concentration and peak
Reactor physics / flux shapes
Fundamental-mode flux shape of a bare reactor at a point
Reactor physics / fuel depletion and burnup
U-235 depletion and energy released at constant flux
U-235 depletion at constant power
Reactor physics / neutron life cycle
Multiplication factor by the four- and six-factor formulas
Reactor physics / power and flux
Power density and power from the fission reaction rate
Reactor physics / power and flux shapes
Reactor power from the peak flux (or peak flux from power) of a bare core
Reactor physics / reflected reactors
Critical thickness of a reflected slab reactor and reflector savings (one group)
Reactor physics / two-group theory
k-effective of a bare reactor in two-group diffusion theory
Shielding / attenuation
Half-value and tenth-value layers
Shielding and dose / attenuation
Linear attenuation coefficient from narrow-beam transmission measurements
Narrow-beam transmission through a multilayer shield
Shielding and dose / dose over time
Dose accumulated near a decaying source
Dose received passing a point source
Stay time to a dose limit near a decaying source
Shielding and dose / extended sources
Uncollided flux from a shielded line source (Sievert integral)
Uncollided flux on the axis of a shielded disk source
Shielding and dose / photon interactions
Klein-Nishina Compton cross sections per electron
Shielding and dose / point sources
Dose rate from a shielded point gamma source with buildup
Shielding and dose / shield design
Shield thickness for a target dose rate (point source, buildup)
Thermal hydraulics / coolant channels
Coolant temperature along a channel with a chopped-cosine power shape
Location and value of the maximum cladding surface temperature
Thermal hydraulics / fuel rods
Fuel centreline temperature with temperature-dependent conductivity
Fuel-rod radial temperatures: centreline, pellet surface and cladding
Out of scope
- Open-ended explanation, essay writing or tutoring dialogue: it is a solver, not a chatbot.
- Questions outside its certified nuclear 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 (radioactive decay chains and activity, radiation shielding and dosimetry, detectors and counting, neutron physics, reactor criticality and kinetics, fission-product poisons, fuel depletion and enrichment, and fuel-rod heat transfer); 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{nuclear_engineering_ai999x_1_0_0,
title = {nuclear-engineering-ai999x: an offline, verified nuclear engineering solver},
author = {Farabi, Ibnul Jaif}, organization = {AI999X},
year = {2026}, version = {1.0.0},
url = {https://huggingface.co/AI999X/nuclear-engineering-ai999x}
}
Contact
Questions, bug reports and requests: open a discussion on https://huggingface.co/AI999X/nuclear-engineering-ai999x/discussions or visit https://ai999x.com.
Support the project
nuclear-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
- 28
Collections including AI999X/nuclear-engineering-ai999x
Evaluation results
- identical on every platform on Golden answers (554 documented questions, Windows + Linux Python 3.10-3.14)self-reported1.000