Hissab Documentation

website·Indexed 33 days ago

https://hissab.io/

A strict, unit-aware natural-language calculator for exact expression work. Hissab supports a wide range of mathematical and scientific operations, including symbolic algebra, unit conversion, finance, statistics, complex numbers, matrices, and IP address manipulation. It features an engine library for deterministic evaluation, a CLI, and AI-powered natural language translation of expressions.

Tokens
23.4K
Snippets
171
Records
214
Agent score
67%

What's inside Hissab

  1. Overview of Hissab Skills for AI Agents

    Hissab Skills are local instructions that teach AI agents (such as Claude, Codex, and OpenCode) when and how to use Hissab for mathematical operations. Instead of performing math within the model, the agent translates natural-language requests into Hissab expressions, executes them via the calculator, and provides the deterministic result to the user.
  2. Overview of Hissab calculator capabilities

    Hissab is a strict, unit-aware natural-language calculator for exact expression work. It evaluates numbers, units, dates, colors, bases, statistics, probability, finance, IP addresses, symbolic algebra, and complex numbers. It is designed to be deterministic, ensuring that humans, scripts, and AI agents receive the same auditable answers across the web app, Chrome extension, CLI, and TypeScript library.
  3. Overview of Hissab's calculation capabilities

    Hissab is a deterministic calculation engine designed to bridge the gap between casual calculators and full programming environments. Unlike natural-language calculators that may guess, Hissab is strict, unit- and type-aware, and covers approximately 25 calculation domains. It provides a consistent engine across a web app, CLI, embeddable library, and as a tool for AI agents.
    25% of 200
    15 kilometers to miles
    emi(500000, 6.5%, 30 years)
    network(192.168.1.130/24)
  4. Understand Hissab's data storage and privacy model

    Hissab is designed as a local-first tool with no central accounts or servers storing user data. Calculations, notebooks, settings, and API keys are stored exclusively in the user's browser (via local storage and IndexedDB) or on their local machine. The product does not sell data, show ads, or build user profiles.
  5. Use Hissab as a web application

    Hissab can be used directly in a modern web browser without installation. All user data—including notebooks, provider settings, MCP servers, and skills—is stored locally within the browser profile.
  6. Understand Hissab's strict parsing behavior

    Hissab uses strict parsing to avoid silent errors. Unknown words or misspelled units make an entire expression invalid. Users should provide clean expressions (e.g., 10 + 10) rather than natural language questions (e.g., what is 10 + 10). For natural language input, the AI layer must be used to translate the request into a clean Hissab expression before evaluation.
  7. Use Hissab functions and expressions

    Hissab functions accept arguments enclosed in parentheses and separated by commas. Each argument can be a literal value or a nested expression.
    avg(99, 34, 65, 213, 45, 123)
    max(10m, 30k, 7.7m)
    bayes(0.01, 0.9, 0.05)
    derivative(2x^2, x)
  8. Install Hissab CLI

    Install the Hissab CLI via npm for local use or globally to enable the hissab command across your system. Verify the installation by running the help command.
    # Local installation
    npm install @rawbytes/hissab-cli
    
    # Global installation
    npm install -g @rawbytes/hissab-cli
    
    # Verify installation
    hissab --help
  9. Simplify and expand algebraic expressions

    Expressions containing symbols are simplified automatically by Hissab, which collects like terms and returns a canonical polynomial output ordered by descending degree. You can also use the explicit simplify(...) function.
    12 + 2x^2 - 4x^2 - 2
    simplify(2x^2 - 4x^2)
    (x + 1)*(x + 2)
  10. Install Hissab using Vercel Skills CLI

    You can install the Hissab CLI-backed skill using the Vercel Skills CLI. You can install it for the current project, globally, or target a specific agent (e.g., claude-code). After installation, restart the agent session to load the new skill instructions.
    # Add skill to project
    npx skills add rawbytess/hissab --skill hissab-cli
    
    # Add skill globally
    npx skills add rawbytess/hissab --skill hissab-cli -g
    
    # Add skill globally for a specific agent
    npx skills add rawbytess/hissab --skill hissab-cli -g -a claude-code
  11. Calculate logarithms with a custom base

    To calculate a logarithm with a base other than e, 10, or 2, use the change of base identity: log(x) / log(base).
    log 343 / log 7
  12. Perform date and time arithmetic

    Hissab allows calendar-based stepping for days, weeks, months, and years (e.g., adding a month to January 31st correctly lands on the last day of February). Hours and minutes are treated as elapsed time. You can also convert between dates, epochs, and timestamps using the to keyword.
    2020.08.07 + 5 days
    2020.08.07 - 5 days
    31 jan 2026 + 1 month
    1 jan 2026 + 280 days
    2020.08.07 - 9 sep 2020 to minutes
    today - 1 feb 1990 to years
    12 mar 2020 utc to epoch
    12 mar 2020 utc to timestamp
    1646480610 seconds to human date
    now in beijing