Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Seaus-tech/Calculator-App/llms.txt

Use this file to discover all available pages before exploring further.

Calculator App is distributed as a standard Python package on PyPI, so installation is a single pip command. If you want to contribute or experiment with the source, a development install from the GitHub repository is equally straightforward. Both paths are covered below.

Standard Installation

1

Check Prerequisites

Calculator App requires Python 3.10 or later. Verify your Python version before proceeding:
python --version
You should see output like Python 3.10.x or higher. If your system Python is older, install a newer version from python.org or use a version manager such as pyenv.
2

Install via pip

Install the package from PyPI with a single command:
pip install calculator-app
This installs the calc_app package and registers the calc-app console script on your PATH.
3

Verify the Installation

Launch the calculator to confirm everything is working:
calc-app
You should see the startup banner printed in your terminal:
Simple Calculator - Type math expressions or 'quit'
Set variables: x=5
Use in math: x+3, 2*x, etc.
Solve equations: 6+x=7, 2*x-3=5
Functions: sqrt(16), 9**2, sin(pi/2)
Natural language: '9 squared', 'sqrt of 16', '5 cubed'
Fractions: 1/2 + 1/3, 2 1/2 + 3/4
Type 'meme' to toggle meme mode!
Once you see the > prompt, the calculator is ready to use.

Development Installation

If you want to hack on the source or run the latest unreleased changes, clone the repository and install it in editable mode:
git clone https://github.com/Seaus-tech/Calculator-App.git
cd Calculator-App
pip install -e .
The -e flag installs the package in editable mode, meaning any changes you make to the source files in calc_app/ take effect immediately the next time you run calc-app — no reinstall required.
The calc-app command is registered via the console scripts entry point defined in pyproject.toml:
[project.scripts]
calc-app = "calc_app.app:main"
This means calc-app in your terminal maps directly to the main() function inside calc_app/app.py. If the command is not found after installation, ensure your Python environment’s bin (or Scripts on Windows) directory is on your PATH.

Build docs developers (and LLMs) love