optimization-ai999x — offline, verified optimization 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: Mathematics & Statistics · Tasks: Question Answering, Sentence Similarity, Feature Extraction
optimization-ai999x is an offline, deterministic Python solver that answers optimization questions with verified results from 72 certified capabilities, gives 240 documented answers identically on Windows and Linux, and refuses rather than guesses when an answer cannot be verified.
optimization-ai999x is a compact, deterministic optimization engine for Python. It reads a question in plain English (or a typed call), picks a certified optimization 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 optimization 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 240 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: linear and integer programming, convex and nonlinear optimisation, assignment, transportation and shortest-route problems, scheduling, inventory, queueing, game theory and multi-criteria decisions.
Model overview
| Property | Value |
|---|---|
| Package | optimization-ai999x 1.0.0 (import optimization_ai999x) |
| Type | Deterministic neuro-symbolic optimization engine (rule-based reading + certified symbolic capabilities) |
| Capabilities | 72 certified procedures |
| Knowledge pack | version 1.0.1 |
| Golden answers | 240 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 optimization-ai999x
# or straight from this repository:
pip install https://huggingface.co/AI999X/optimization-ai999x/resolve/main/dist/optimization_ai999x-1.0.0-py3-none-any.whl
import optimization_ai999x as optimization
optimization.ask("Solve the transportation problem with supply [20, 30], demand [10, 25, 15] and cost matrix [[2, 3, 1], [5, 4, 8]].").show()
# -> SOLVED — min_cost = 150, shipments = [[5.0, 0.0, 15.0], [5.0, 25.0, 0.0]], plan_unique = yes, dual = [-3.0, 0.0, 5.0, 4.0, 4.0] (transportation_problem)
optimization.ask("Find the shortest path from A to D in the undirected graph with edges A-B 4, A-C 2, B-C 1, B-D 5, C-D 8.").show()
# -> SOLVED — distance = 8, path = ['A', 'C', 'B', 'D'], path_unique = yes (shortest_path)
optimization.solve("eoq", D=1200, S=50, H=3).show()
# -> SOLVED — Q = 200, total_cost = 600, orders_per_period = 6, cycle_time = 0.166667 (eoq)
optimization.ask("Find the AHP consistency ratio for the pairwise judgments [3, 5, 2].").show()
# -> SOLVED — CR = 0.003185, CI = 0.0018473, lambda_max = 3.00369, weights = [0.6483290138222366, 0.2296507940626371, 0.12202019211512621] (ahp_consistency_ratio)
optimization.ask("Find the pure-strategy Nash equilibria of the bimatrix game with row payoffs [[3, 0], [5, 1]] and column payoffs [[3, 5], [0, 1]].").show()
# -> SOLVED — count = 1, equilibria = [[2.0, 2.0]] (pure_nash_equilibria)
optimization.ask("Who created you?").message
# -> optimization-ai999x was created and engineered by Ibnul Jaif Farabi at AI999X.
Command line: optimization-ai999x "<question>", optimization-ai999x --capabilities. The outputs above were produced by running this exact code on optimization-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
72 certified procedures. A few of them:
- Procedures: 0/1 knapsack problem; 2 x 2 zero-sum game (saddle point or mixed-strategy formula); AHP consistency ratio; AHP priority vector (principal eigenvector); AHP weights by the geometric mean method; Absolute extrema of a polynomial on a closed interval; All-pairs shortest distances (Floyd-Warshall); Assignment problem (Hungarian method), maximum total value; Assignment problem (Hungarian method), minimum total cost; Bin packing (minimum number of bins); Break-even quantity; Chromatic number (minimum graph colouring); Closed cylinder of least surface area for a given volume; Critical path method (project duration and slack); Critical point of a two-variable quadratic and its classification; Discounted Markov decision process (optimal values and policy); Dynamic lot sizing (Wagner-Whitin); EOQ with planned backorders; Earliest due date rule (minimum maximum lateness); Economic order quantity (EOQ); Economic production quantity (EPQ); Equality-constrained quadratic program (Lagrange multipliers / KKT); Erlang B blocking probability (M/M/c/c loss system); Integer linear program (branch and bound) …
optimization_ai999x.templates() lists every question form ask() reads; the capability guide (PDF, every example executed) is included in this repository.
All 72 formulas
Show every formula, by topic
Calculus optimisation / geometry
Closed cylinder of least surface area for a given volume
Largest rectangle for a given length of fencing
Open box of maximum volume from a rectangular sheet
Calculus optimisation / one variable
Absolute extrema of a polynomial on a closed interval
Calculus optimisation / several variables
Critical point of a two-variable quadratic and its classification
Cost-volume-profit analysis
Break-even quantity
Dynamic programming / Markov decision processes
Discounted Markov decision process (optimal values and policy)
Dynamic programming / inventory
Dynamic lot sizing (Wagner-Whitin)
Economic optimisation / monopoly pricing
Profit-maximising output with linear demand
Economic optimisation / pricing
Revenue-maximising price with linear demand
Game theory / non-zero-sum games
Mixed-strategy Nash equilibrium of a 2 x 2 game
Pure-strategy Nash equilibria of a bimatrix game
Game theory / zero-sum games
2 x 2 zero-sum game (saddle point or mixed-strategy formula)
Two-person zero-sum game (value and optimal mixed strategies)
Integer programming
Integer linear program (branch and bound)
Integer programming / covering
Minimum vertex cover (and maximum independent set)
Minimum-cost set cover
Integer programming / graph colouring
Chromatic number (minimum graph colouring)
Integer programming / knapsack
0/1 knapsack problem
Unbounded knapsack problem
Integer programming / location
Uncapacitated facility location
Integer programming / packing
Bin packing (minimum number of bins)
Inventory management
EOQ with planned backorders
Economic order quantity (EOQ)
Economic production quantity (EPQ)
Order quantity with quantity discounts (all-units)
Periodic-review order-up-to level
Reorder point with safety stock
Inventory management / single-period
Newsvendor order quantity (discrete demand)
Newsvendor order quantity (normal demand)
Newsvendor order quantity (uniform demand)
Linear programming
Linear program (simplex method)
Two-variable linear program (graphical corner-point method)
Linear programming / sensitivity analysis
Shadow prices of a linear program
Multi-criteria decision analysis
TOPSIS ranking (closeness to the ideal solution)
C_i = \frac{D_i^-}{D_i^+ + D_i^-},\quad D_i^\pm = \Big\\vert w \odot r_i - v^\pm \Big\\vert _2
Weighted product model
Weighted sum model (simple additive weighting)
Multi-criteria decision analysis / AHP
AHP consistency ratio
AHP priority vector (principal eigenvector)
AHP weights by the geometric mean method
Network optimisation / assignment
Assignment problem (Hungarian method), maximum total value
Assignment problem (Hungarian method), minimum total cost
Network optimisation / flows
Maximum flow and minimum cut (Edmonds-Karp)
Minimum-cost flow (transshipment)
Network optimisation / matching
Maximum bipartite matching
Maximum-weight matching (general graph)
Network optimisation / routing
Travelling salesman tour (exact, Held-Karp)
Network optimisation / shortest routes
All-pairs shortest distances (Floyd-Warshall)
Shortest path (Dijkstra's algorithm)
Shortest path with negative weights (Bellman-Ford)
Network optimisation / spanning trees
Minimum spanning tree (Kruskal's algorithm)
Network optimisation / transportation
Transportation problem (minimum shipping cost)
Nonlinear optimisation / descent methods
Steepest descent step with exact line search (quadratic)
Nonlinear optimisation / quadratic
Equality-constrained quadratic program (Lagrange multipliers / KKT)
Unconstrained quadratic minimisation
Project scheduling
Critical path method (project duration and slack)
PERT project duration and completion probability
Queueing theory
M/G/1 queue (Pollaczek-Khinchine formula)
M/M/1 queue
M/M/c queue (Erlang C)
M/M/c/K queue (finite capacity)
Machine-repair (finite-source) queue
Queueing theory / staffing
Minimum number of servers for a service target (Erlang C)
Queueing theory / teletraffic
Erlang B blocking probability (M/M/c/c loss system)
Revenue management
Littlewood's rule (two-fare protection level)
Scheduling / flow shop
Johnson's rule (two-machine flow shop)
Scheduling / parallel machines
Minimum makespan on identical parallel machines
Scheduling / single machine
Earliest due date rule (minimum maximum lateness)
Moore-Hodgson algorithm (minimum number of tardy jobs)
Shortest processing time rule (minimum mean flow time)
Weighted shortest processing time (Smith's rule)
Unconstrained optimisation / one variable
Optimum of a quadratic function
Out of scope
- Open-ended explanation, essay writing or tutoring dialogue: it is a solver, not a chatbot.
- Questions outside its certified optimization 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 (linear and integer programming, convex and nonlinear optimisation, assignment, transportation and shortest-route problems, scheduling, inventory, queueing, game theory and multi-criteria decisions); 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{optimization_ai999x_1_0_0,
title = {optimization-ai999x: an offline, verified optimization solver},
author = {Farabi, Ibnul Jaif}, organization = {AI999X},
year = {2026}, version = {1.0.0},
url = {https://huggingface.co/AI999X/optimization-ai999x}
}
Contact
Questions, bug reports and requests: open a discussion on https://huggingface.co/AI999X/optimization-ai999x/discussions or visit https://ai999x.com.
Support the project
optimization-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
- 18
Collections including AI999X/optimization-ai999x
Evaluation results
- identical on every platform on Golden answers (240 documented questions, Windows + Linux Python 3.10-3.14)self-reported1.000