Skip to content

About

An open-source mathematical workspace for step-by-step solutions, symbolic computation, and interactive 2D/3D visualization. Built for learning and exploring mathematics.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

English | Tiếng Việt



MathWeave Studio Logo

MathWeave Studio

An interactive mathematical workspace for pedagogical step-by-step solutions, independent symbolic verification, and 2D/3D visualization.

MathWeave Studio is designed to help students and researchers understand mathematical reasoning and transformation rules, rather than treating computer algebra as a black-box answer engine.

License: GPL-3.0 Python 3.14+ Status: MVP v0.1.0


Overview

Most mathematical software outputs only a final answer, leaving learners unsure of how a solution was derived or whether intermediate steps are sound.

MathWeave Studio bridges this gap by combining:

  • Symbolic Computation: Exact mathematical computation powered by SymPy.
  • Pedagogical Derivation Engine: Step-by-step decomposition of standard calculus rules (Power, Sum, Product, Quotient, Chain, Trig rules) with expandable substeps.
  • Dual-Layer Independent Verification: Every solution is independently cross-checked against reference symbolic invariants and multi-point numerical probing.
  • Interactive Visualization: 2D function plotting with automatic singularity/asymptote detection, standardized 3D surface visualization, and variation tables (bảng biến thiên).

Note on Versioning: MathWeave Studio is currently in active MVP development (v0.1.0). Pushing commits to GitHub does not publish a new release version; a GitHub Release and matching Git tag must be created for release-tracking badges to update automatically.


Features

Calculus

  • Derivatives: First-order and higher-order derivatives ($f^{(n)}(x)$ up to order 10) and partial derivatives ($\frac{\partial f}{\partial x}$, $\frac{\partial f}{\partial y}$).
  • Integrals: Indefinite integration with rule breakdown and integration constant $+ C$; definite integrals over $[a, b]$ via the Fundamental Theorem of Calculus.
  • Limits: Two-sided and one-sided limits ($\lim_{x \to a^{\pm}}$) at finite points and infinities ($\pm\infty$).
  • Geometry & Multivariable: Arc length, surface area, surfaces/solids of revolution, line and surface integrals, and triple integrals (Cartesian, cylindrical, spherical).

Linear Algebra

  • Determinants: $2 \times 2$ formula and Laplace expansion for higher-order matrices.
  • Matrix Inverses ($A^{-1}$): Invertibility checks ($\det A \ne 0$) and adjugate matrix calculation.
  • Echelon Forms: Gaussian elimination (REF) and Gauss-Jordan elimination (RREF) with elementary row operations.
  • Matrix Operations: Addition, subtraction, multiplication ($A \times B$), and transpose ($A^T$).
  • Linear Systems ($Ax = b$): Augmented matrix $[A | b]$ solving with complete solution classification.

Verification & Rationale

  • Dual-Layer Auditing: Every result displays an audit badge (Verified via symbolic invariant or Numerical Probe sampling with error $< 10^{-9}$).
  • Domain Restrictions ($\mathcal{D}$): Automatic detection of non-zero denominator conditions, non-negative radical constraints, and trigonometric singularities.

Visualization

  • 2D Plotting (Plotly): Interactive graphs with zoom, pan, and automatic pole detection to prevent invalid line connections across vertical asymptotes.
  • 3D Visualization: Isometric 3D surfaces and space curves with RGB coordinate axes (X=Red, Y=Green, Z=Blue).
  • Variation Tables: Academic variation tables showing domain, critical points, poles (double bar ||), derivative signs, and monotonicity arrows.

Installation

MathWeave Studio is primarily developed and tested on Arch Linux.

Quick Start (Arch Linux via uv)

  1. Clone the repository:

    git clone https://github.com/TqvNoCode/MathWeave-Studio.git
    cd MathWeave-Studio
  2. Synchronize dependencies:

    uv sync
  3. Launch the application:

    uv run run.py --browser

Open your browser at: http://localhost:8080

For complete Arch Linux instructions—including future AUR installation placeholders, system dependencies, running with standard virtual environments, and uninstallation—see the Arch Linux Installation Guide.

Windows Standalone Desktop Application

Download MathWeaveStudio-Beta.exe from GitHub Releases. Double-click the executable to launch MathWeave Studio directly in a native desktop window without installing Python or uv.

System Prerequisites for Windows Native Mode: MathWeave Studio uses Microsoft Edge WebView2 for its native desktop window. WebView2 is pre-installed on Windows 11 and modern Windows 10 versions. If running on a stripped or offline Windows edition without WebView2, install the official Microsoft Edge WebView2 Evergreen Runtime, or launch with --browser from the command prompt.

Building Standalone EXE on Windows:

uv sync --all-groups
uv run pyinstaller mathweave-studio-onefile.spec --clean --noconfirm

Documentation


Development & Testing

MathWeave Studio maintains an automated test suite enforcing Clean Architecture boundary isolation, solver mathematical validity, and UI stability:

# Run all 229 automated tests
uv run pytest

All 229 tests pass with 100% success rate.


License & Author

  • License: GNU General Public License v3.0 (GPL-3.0).
  • Author: TQV (TqvNoCode — 92263302+TqvNoCode@users.noreply.github.com)
  • Copyright: © 2026 by TQV

About

An open-source mathematical workspace for step-by-step solutions, symbolic computation, and interactive 2D/3D visualization. Built for learning and exploring mathematics.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages