nikolaeu

numi: Calculate with Natural-Language Expressions

Numi is a calculator for expressing calculations, conversions, and date arithmetic in everyday language. Its desktop app and command-line version suit people who want quick answers without building expressions in a conventional calculator.

View on GitHub Compare
Stars
6.5k
Forks
257
Stars, last 30 days
+20

Our take

Health score

31/100

How it is scored
Activity
35
Community
49
Issues
21
Pull requests
20

+20 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

6,540

Forks

260

Change since Nov 16, 2026: 0 stars·0 forks

Overview

Numi turns plain-language expressions into calculations, conversions, and date arithmetic. Instead of entering a formula step by step, you can write something like a price with a discount or a date plus a time period and get an answer directly.

The project provides a desktop app and a terminal version. It is useful for people who want a more expressive calculator for everyday work, while the CLI also makes calculations available from a command line or scripts.

Key Features

  • Interprets natural-language calculations, such as prices with discounts.
  • Converts units, with examples including inches to centimeters and currencies.
  • Supports date arithmetic, such as adding weeks to today.
  • Provides a desktop calculator and a command-line version.
  • Offers an Alfred extension that works with the terminal version.
  • Supports installing the CLI with a shell command or Homebrew.

Use Cases

  • Quickly calculate a discounted purchase price without entering a formula manually.
  • Convert measurements or currencies while working, without switching to a separate conversion tool.
  • Work out dates and time periods using expressions such as “today + 2 weeks.”
  • Run a supported calculation from a terminal when a command-line workflow is more convenient.
  • Use the Alfred extension for quick access, provided the terminal version is installed.

Getting Started

Install the terminal version with:

curl -sSL https://s.numi.app/cli | sh

Then try numi-cli "20 inches in cm". For desktop downloads and other installation options, see the README and Numi website.

Considerations

The README says the terminal version supports most desktop features, but lists timezone conversion, CSS, variables, and plugins or extensions as not yet implemented. The README describes the desktop app primarily for macOS, while also linking to a Windows installer; check the project website for current platform details. The CLI installer command downloads and runs a shell script.

Found this useful?

Share it with someone who would like numi.