Skip to content

Latest commit

 

History

384 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UzonCalc

AI-Oriented Calculation Report Authoring Software - Enterprise-Grade, AI-Native, Automatic Calculation, Automatic Layout

English · 中文

UzonCalc-welcom.mp4

UzonCalc is an AI-oriented calculation report authoring tool. It enables AI to help engineers quickly generate and revise calculation reports, so they can be written once and reused indefinitely.

With UzonCalc, you only need to focus on the calculation logic. The framework automatically substitutes variable values, generates calculation steps, renders mathematical formulas, and lays out the document to produce professional calculation reports.

UzonCalc calculation reports are written in native Python syntax without proprietary conventions, making them easy to learn and quick to use.

Combined with AI, UzonCalc can dramatically improve your productivity.

Features

  • 🤖 AI-Friendly - Includes a SKILL that lets AI quickly generate and revise calculation reports
  • 🐍 Native Python - Uses Python syntax, making it easy to learn yet highly extensible because you can use Python to implement any idea
  • 📐 Automatic Formula Rendering - Automatically substitutes variable values and displays calculation steps
  • 📌 Automatic Layout - Automatically lays out content according to calculation results, with no manual adjustment required
  • 📏 Unit Calculations - Automatically performs unit conversion and dimensional checks, so you do not need to track unit changes during calculation
  • 📊 Chart Support - Supports many types of charts through ECharts, SVG, and Matplotlib
  • 📋 Excel Reuse - Supports automatically invoking Excel for calculations and extracting results
  • 📄 Multiple Output Formats - Uses standard MathML and supports conversion to PDF and Word

Comparison

Feature UzonCalc Calcpad EngineeringPaper.xyz
Underlying stack Python + AI ecosystem C# (.NET 10) proprietary engine Python (Pyodide) + SymPy engine
Authoring syntax Native Python, highly extensible Proprietary syntax, limited extensibility Visual operations
Performance Relatively high, using Python code Relatively lower than Python with custom script parsing Runs on the web, lower efficiency
AI friendliness Very high Low None
Excel calculation reuse Supported Not supported Not supported
Automatic table of contents Supported Not supported Not supported
Automatic chapter and figure numbering Supported Not supported Not supported
Cross-references for figure numbers Supported Not supported Not supported
String variables Supported Not supported Supported

Quick Start

Windows

  1. Download the software

    Download the win-x64 version from Releases · uyoufu/UzonCalc or the official download page. Extract the archive, then double-click UzonCalc.exe to start.

  2. Click "New" to create a calculation report.

    image-20260729190251526

  3. Copy the following code into the main.py file in the new calculation report screen.

    from uzoncalc import *
    
    @uzon_calc()
    async def sheet():
        doc_title("example")
    
        "Hello, UzonCalc!"
    
        w = 10*unit.m
        l = 5*unit.m
        A = w * l
  4. Click the Run button to execute it.

    image-20260729190437532

  5. Result

    image-20260729190451176

CLI

The CLI is primarily intended for calculation report authors. It provides automatic formatting and syntax checks to improve authoring efficiency. When editing calculation reports, VS Code is recommended, together with AI assistance for charts and complex calculation logic.

To use the CLI, follow these steps:

  1. Ensure that Python 3.13 or later is installed.

    Check the Python version:

    python --version
  2. Create a calculation report file named example.py.

    Add the following content:

    # example.py
    
    from uzoncalc import *
    
    @uzon_calc()
    async def sheet():
        doc_title("example")
    
        "Hello, UzonCalc!"
    
        w = 10*unit.m
        l = 5*unit.m
        A = w * l
    
    if __name__ == "__main__":
        view(sheet)
  3. Run it to view the result.

    Run either command in a terminal:

    # Option 1: Run the Python script directly
    python example.py
    
    # Option 2: Use the uzoncalc command
    uzoncalc --serve example.py

    You will see Serving document at: http://127.0.0.1:32180/. Click the URL or open it in a browser to view the result.

Online Examples

Document Source Online Preview
User Guide help.en-US.py View Document
T-Shaped Section Moment of Inertia T_section_moment_of_inertia.py View Document

Contact

Li Youfu: uyoufu@uzoncloud.com

More

Official UzonCalc Website

License

MIT License

About

UzonCalc is for writing engineering calculation reports using Python and AI. UzonCalc 是一个可以使用 python+ AI 来编写工程计算书的软件

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages