Namishu Arithmetic

Printable arithmetic worksheets for integers, fractions, and decimals.

English · 简体中文

Quick start · Level catalog · Commands · Agent guide

Namishu Arithmetic creates printable arithmetic worksheets for parents preparing daily practice, teachers assigning classwork, and learners practicing specific operations. Choose an exercise type and page count to get an A4 PDF ready to print, saving the time spent writing questions and arranging them on a page. Run it again whenever you need a fresh set of questions.

With 68 levels across 3 series, the project covers addition, subtraction, multiplication, and division with integers, fractions, and decimals, including negative numbers, parentheses, mixed operations, and missing-number exercises. Choose a preset for your practice goal, adjust the layout and number of problems per page, or fix the random seed to generate the same set of questions again.

Sample PDFs: Addition · Multiplication · Fractions · Decimals

Installation

Requirements: Python 3.10+ and uv.

git clone https://github.com/namishu/arithmetic.git
cd arithmetic
uv sync

Run the commands below from the project directory.

Quick start

Choose a series and level to generate a worksheet:

Each level identifies an exercise preset, described in the level catalog. For example, addsub level 1 adds two integers from 0 to 10; sums may reach 20.

Generate a PDF

Generate five pages of addition practice, saved to worksheets/addition.pdf:

uv run arithmetic generate --series addsub --level 1 --pages 5 --output worksheets/addition.pdf

generate creates a PDF. The four arguments above specify:

The command prints the file location when complete. Open the PDF and print at actual size on A4 paper.

You can also add these options:

For example, generate two pages of division practice with no division by zero and a fixed seed:

uv run arithmetic generate --series muldiv --level 5 --pages 2 --seed 42 --disallow-zero-denominator --output worksheets/division.pdf

You can also give the repository URL or local folder to an agent that can run commands, with a request:

Use this project to generate five pages of basic multiplication practice without negative operands, saved in worksheets/. Verify the PDF and provide a file link and the generation settings.

Other commands

List exercises: list

Show every series, level, and exercise name. Use --series to filter by series, or --json for JSON output.

uv run arithmetic list
uv run arithmetic list --series muldiv

Inspect a level: describe

Show operand ranges, operation rules, examples, and problems per page for one level. Both --series and --level are required; --json returns JSON output.

uv run arithmetic describe --series muldiv --level 5

Generate a complete collection: generate --all

Create a separate PDF for each of the 68 levels. This command generates one page per level:

uv run arithmetic generate --all --pages 1 --output-dir worksheets/collection

--all selects every exercise; --output-dir sets the root directory, defaulting to worksheets. Files are stored as {series}/level-{level}.pdf. Batch generation accepts --pages, --seed, --disallow-zero-denominator, --config, --force, and --json. It cannot be combined with --series, --level, or --output. --output-dir is only available with --all.

Help and version

uv run arithmetic --help
uv run arithmetic generate --help
uv run arithmetic --version

list and describe also accept --help.

Default configuration

Series and level must be selected explicitly. Each blank always requires a unique valid rational solution. Save an override as worksheet.yaml to adjust problems per page, margins (in millimeters), and line spacing. Only supplied settings change; other settings keep their defaults.

problems_per_page:
  default: 12
layout:
  margin:
    left_mm: 20
    right_mm: 20
  typography:
    line_spacing_ratio: 1.0

uv run arithmetic generate --series addsub --level 1 --config worksheet.yaml

default sets the integer series capacity; use fraction alongside it to set the fraction series capacity. The four levels with a fixed 12-question capacity retain that value. See examples/override.yaml for a ready-to-use file.

License

Code and original documentation use the MIT License. Generated worksheets may be printed, shared, modified, and sold. Third-party assets follow their own license terms.