Skip to main content

Superion S1 Tool (LlamaIndex)

pip install llama-index-tools-superion
export SUPERION_API_KEY="s1k_..."   # free key: https://punkytigerlabs.com/s1/

This tool spec gives LlamaIndex agents calibrated judgement from Superion S1 by Punky Tiger Labs: yes/no, choice and score decisions about a text, with calibrated probabilities from one API call and no text generation. Use it to classify, moderate, triage, rate leads or decide whether an action is safe.

tool arguments returns (JSON)
decide_yes_no text, question {"p_yes": 0.97}
classify text, question, options (2–255) {"best": "billing", "probabilities": {...}}
score text, question, levels (2–16, lowest first) {"best": "high", "expected_level": 1.8, "probabilities": {...}}

All three have async versions, used automatically by async agents.

Usage

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from llama_index.tools.superion import SuperionToolSpec

agent = FunctionAgent(
    tools=SuperionToolSpec().to_tool_list(),
    llm=OpenAI(model="gpt-5-mini"),
)
await agent.run("Ticket: my card was charged twice for order #4411, fix it today!")

Or call it directly:

spec = SuperionToolSpec()
spec.classify("Ticket: my card was charged twice", "Which team should handle it?", ["billing", "tech", "sales"])
# '{"best": "billing", "probabilities": {"billing": 0.98, ...}}'

SuperionToolSpec(api_key=None, model=..., base_url=None, timeout=120.0) — api_key defaults to SUPERION_API_KEY.

About Superion S1

#1 of 214 on S1MB English v1 — Task Average 75.06 · Borda 89.82 (12 Nov 2026) — leaderboard. Calibrated probabilities, one call, no text generation, sub-second, deterministic within a pinned model version. Built on Gemma 4 26B-A4B, INT4 experts.

Plan Price
Free 20 M input tokens per day per key, permanent
Prepaid 0.042 USD per million input tokens, output free
Contract dedicated key, price on request

Get a key: https://punkytigerlabs.com/s1/ · Docs: https://punkytigerlabs.com/s1/docs · Status: https://punkytigerlabs.com/s1/status

Custom & industry models

Punky Tiger Labs also builds custom and industry-specific decision models — fitted to your own taxonomy, labels and data, for a specific industry or objective — served on a dedicated instance. Contact: alvaro.lopez@punkytigerlabs.com.

License

This client is MIT-licensed (see LICENSE). The Superion S1 model and API are proprietary services of Punky Tiger Labs, Inc., used under the API terms.

Metadata

Release files for llama-index-tools-superion 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for llama-index-tools-superion 0.1.0
File Size Uploaded Provenance Actions
llama_index_tools_superion-0.1.0.tar.gz 4.3 kB Without provenance Details for llama_index_tools_superion-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for llama-index-tools-superion 0.1.0
File Interpreter ABI Platform Actions
llama_index_tools_superion-0.1.0-py3-none-any.whl Python 3 none any Details for llama_index_tools_superion-0.1.0-py3-none-any.whl

Total release size: 9.7 kB

Release files / llama_index_tools_superion-0.1.0.tar.gz

Download URL llama_index_tools_superion-0.1.0.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a0965544fa0d1c3e90b884a0950994dd31117b00299c7554ce95eac6c8042c35
BLAKE2b-256 checksum
How to use checksums
6cdbd7a40666d00222c2a3de7bf47cdaecfd63249e32e1372016d30a3d4e4914
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / llama_index_tools_superion-0.1.0-py3-none-any.whl

Download URL llama_index_tools_superion-0.1.0-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1e90cb42fb08f1b57edf16ba7d52961c412df6ad069b5f33e4a044dbee3a8e7a
BLAKE2b-256 checksum
How to use checksums
d7d96973f350bf09b8b957653bad14f0fada94bc84e2978a9020c672ecfa3f88
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for llama-index-tools-superion 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page