CalcLane

Open-source Standard and Scientific calculator — browser app, engine SDK, CLI, MCP, and hosted API for agents.

CalcLane is a Talocode product: self-hostable, local-first, and built for real use.

| Surface | Install / URL | |---------|----------------| | Browser | Open index.html or npm start | | npm | npm i @talocode/calclane | | CLI | npx @talocode/calclane eval "2+3*4" | | MCP | npx @talocode/calclane mcp | | PyPI | pip install talocode-calclane | | Hosted API | https://api.talocode.site/v1/calclane/* | | Auth | Authorization: Bearer $TALOCODE_API_KEY |

v0.3 — Engine SDK + CLI + MCP + Python client + hosted evaluate/dispatch (1 credit each).

Principles (Talocode)

• Open-source first — MIT, run it yourself
• Local free, cloud metered — offline eval costs nothing; hosted API uses wallet credits
• Agents first — JSON in/out, MCP tools, same contract on npm and PyPI

Quick start

Browser UI

cd calclane
npm start          # http://localhost:4173
npm run test:engine

Node SDK (local, free)

npm i @talocode/calclane

import { evaluateExpression, createCalcLaneClient } from '@talocode/calclane'

console.log(evaluateExpression('2 + 3 * 4'))
// { ok: true, result: 14, display: '14', mode: 'scientific', ... }

const client = createCalcLaneClient()
console.log(client.evaluateLocal('sin(90)', { angle: 'deg' }))

CLI

npx @talocode/calclane eval "2^10"
npx @talocode/calclane eval "sin(90)" --angle deg
npx @talocode/calclane pricing
npx @talocode/calclane mcp          # stdio MCP server

Hosted API (credits)

export TALOCODE_API_KEY=your_key
export TALOCODE_BASE_URL=https://api.talocode.site   # default

# 1 credit
curl -sS -X POST "$TALOCODE_BASE_URL/v1/calclane/evaluate" \
  -H "Authorization: Bearer $TALOCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expression":"2+3*4","mode":"scientific"}'

import { createCalcLaneClient } from '@talocode/calclane'

const cloud = createCalcLaneClient({ preferLocal: false })
const r = await cloud.evaluate('sqrt(144)')  // uses API when key set + preferLocal false
// or always:
await cloud.evaluateRemote('2^10')

Python

pip install talocode-calclane

from calclane import CalcLaneClient

client = CalcLaneClient()  # local free by default
print(client.evaluate("2 + 3 * 4"))

# Hosted (1 credit)
client = CalcLaneClient(prefer_local=False)  # needs TALOCODE_API_KEY
print(client.evaluate("sin(90)", angle="deg", remote=True))

calclane eval "5!"
calclane eval "2+3*4" --remote

Hosted API

Base: https://api.talocode.site

Auth (required for all /v1/calclane/* routes):

• Authorization: Bearer $TALOCODE_API_KEY
• or X-Api-Key: $TALOCODE_API_KEY

| Method | Path | Credits | Description | |--------|------|---------|-------------| | GET | /v1/calclane/health | free* | Service health | | GET | /v1/calclane/pricing | free* | Credit table | | GET | /v1/calclane/capabilities | free* | Modes & endpoints | | POST | /v1/calclane/evaluate | 1 | Evaluate expression | | POST | /v1/calclane/dispatch | 1 | Run engine commands |

*Still requires a valid API key; no credit charge.

POST /v1/calclane/evaluate

{
  "expression": "2 + 3 * 4",
  "mode": "scientific",
  "angle": "deg"
}

Response:

{
  "ok": true,
  "expression": "2 + 3 * 4",
  "result": 14,
  "display": "14",
  "mode": "scientific",
  "angle": "deg",
  "engine": "calclane",
  "version": "0.3.0",
  "usage": { "credits": 1, "action": "calclane.evaluate", "remaining": 99 }
}

Modes

| Mode | 2 + 3 * 4 | |------|-------------| | scientific (default) | 14 (precedence) | | standard | 20 (left-to-right) |

Functions: sin cos tan asin acos atan log ln sqrt cbrt abs floor ceil round exp fact, constants pi e, operators + - * / % ^ ** !, parentheses.

Architecture

lib/           # TypeScript package (engine, evaluate, client, CLI, MCP)
src/engine/    # Browser pure-JS engine (web UI)
src/ui/        # Browser UI
python/        # talocode-calclane PyPI package

| Layer | Role | |-------|------| | Engine | Commands in → state out (CalcEngine) | | Evaluate | Expression string → result (agents) | | Client | Local or api.talocode.site | | Hosted | Stacklane /v1/calclane/* + wallet credits |

MCP tools

| Tool | Description | |------|-------------| | calclane_evaluate | Evaluate expression (local or remote: true) | | calclane_dispatch | Engine command stream | | calclane_health | Health | | calclane_pricing | Credits | | calclane_capabilities | Feature list |

Stacklane Cloud MCP also exposes the same tools against the hosted routes.

Tests

npm run build
npm run test:pkg      # package evaluate/engine tests
npm run test:engine   # browser engine tests

Talocode ecosystem

| Project | What it is | |---------|------------| | Codra | Local-first agentic coding | | Tera | AI learning companion | | Stacklane | Cloud control plane | | SearchLane | Agent web search | | DocuLane | Office document CLI | | WorkLane | Workflow engine | | InvoiceLane | Invoice / receipt intelligence | | CalcLane (this repo) | Open calculator |

More: github.com/talocode · talocode.site · docs.talocode.site

Roadmap

• Programmer mode (hex / bin / bit ops)
• Unit converter
• Session-based remote calculator state

License

MIT © Talocode

Support

Sponsor: https://github.com/sponsors/Abdulmuiz44