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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.