mathguru

MathGuru Unified Platform

Powered by Kontyra

MathGuru is a unified ecosystem-grade mathematics platform for CLI + SDK workflows: symbolic math, graphing, LaTeX conversion, formulas, trainer exercises, markdown math tools, conversions, exports, and sessions.

Install

npm install mathguru
npm install -g mathguru

CLI aliases: mathguru and mg.

CLI Examples

mathguru calc "diff(x^2)"
mathguru differentiate "x^3 + 2*x"
mathguru integrate "sin(x)"
mathguru solve "x^2 - 4 = 0"
mathguru graph "sin(x)"
mathguru graph "x^2" --format svg --size 640x360
mathguru latex "sin(x)^2 + cos(x)^2"
mathguru formula economics cobb-douglas
mathguru search derivative
mathguru explain inflation
mathguru trainer calculus --difficulty medium --count 3
mathguru convert 5 km miles
mathguru median 1 3 5 9
mathguru stats-summary 1 2 2 4 5
mathguru circle-area 5
mathguru hypotenuse 3 4
mathguru matrix-multiply "[[1,2],[3,4]]" "[[5,6],[7,8]]"
mathguru matrix-det "[[1,2],[3,4]]"
mathguru md notes.md
mathguru doctor

Shell Mode

mathguru shell

Shell supports persistent commands, history, help, clear, stats, exit, and symbolic shorthand such as:

mathguru> integrate(sin(x))
mathguru> graph x^2

SDK Examples (CommonJS)

const mathguru = require('mathguru');

mathguru.calc.integrate('sin(x)');
mathguru.graph.plot('x^2', { size: '40x20' });
mathguru.latex.convert('x^2 + 1');
mathguru.formulas.get('cobb-douglas', 'economics');
mathguru.finance.compoundInterest(1000, 5, 2, 12);
mathguru.statistics.summary([1, 2, 2, 4, 5]);
mathguru.geometry.distance2d(0, 0, 3, 4);
mathguru.matrix.multiply(
  [
    [1, 2],
    [3, 4],
  ],
  [
    [5, 6],
    [7, 8],
  ]
);

Session and Export

mathguru save-session demo
mathguru load-session demo
mathguru export-session csv demo
mathguru export history markdown

Configuration

mathguru config set precision 2
mathguru config set graphSize 80x20
mathguru config set graphFormat svg
mathguru config set exportFormat markdown

Testing and Validation

npm test
npm run coverage
npm run doctor
npm run benchmark

Professional test suite covers calc, formulas, graph, latex, trainer, markdown, cli, shell, sdk, config/export/session/history, conversion, parser, and integration.

New Feature Areas

• Statistics: median, mode, range, variance, standard deviation, and summary.
• Geometry: circle area, rectangle area, triangle area, hypotenuse, and 2D distance.
• Calculus shortcuts: direct differentiate, integrate, simplify, and solve commands.
• Matrix math: add, subtract, multiply, transpose, determinant, and inverse.

Future-ready (not implemented yet)

Prepared architecture (not implemented by design):

• AI integrations and AI tutor
• VSCode extension
• local REST API server
• cloud sync/collaboration

Contributing

See CONTRIBUTING.md, RELEASE.md, and docs/.

License

MIT