CalcLane (Python)

Open calculator for agents — local expression evaluation plus hosted Talocode API client.

Part of Talocode — open tools people trust; hosted power under docs.talocode.site.

Why CalcLane?

Agents need deterministic math as a tool, not a free-form LLM guess:

• Structured JSON — ok, result, display, mode, error
• Local free path — stdlib evaluator, no network
• Hosted path — same contract on Talocode Cloud (1 credit per evaluate)
• CLI — calclane eval "2+3*4"

Install

pip install talocode-calclane

Requires Python 3.10+. Stdlib only (no extra runtime deps).

Quickstart

import os
from calclane import CalcLaneClient

client = CalcLaneClient()

# Local (free)
print(client.evaluate("2 + 3 * 4"))
print(client.evaluate("sin(90)", angle="deg"))
print(client.evaluate("5!"))

# Hosted API (1 credit) — needs TALOCODE_API_KEY
cloud = CalcLaneClient(
    api_key=os.environ["TALOCODE_API_KEY"],
    prefer_local=False,
)
print(cloud.evaluate_remote("sqrt(144)"))

Environment

CLI

calclane eval "2^10"
calclane eval "sin(90)" --angle deg
calclane health
calclane pricing
calclane eval "pi*2" --remote   # hosted, 1 credit

Or: python -m calclane eval "...".

API surface

*Valid API key required; no credit charge.

Auth: Authorization: Bearer $TALOCODE_API_KEY or X-Api-Key.

Related packages

Talocode ecosystem

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

License

MIT © Talocode