kongenlabs 1.1.0

Kongen Labs SCI Pattern Intelligence SDK -- cross-domain pattern transfer and LLM reasoning regime detection

Kongen SDK

Python SDK for the Kongen Labs Pattern Intelligence API -- pattern transfer scoring and LLM reasoning regime detection.

Install

pip install kongenlabs

Quick Start

from kongen import KongenClient

client = KongenClient(api_key="kl_live_...")

# Logic: LLM reasoning regime detection (1 KT)
result = client.logic.score("Prove that sqrt(2) is irrational")
print(result.regime, result.confidence_adj)

# Transfer: Pattern scoring (50 KT)
result = client.transfer.score_signal({
    "complexity": 0.7,
    "constraint": 0.3,
    "boundary": 0.8,
    "coherence": 0.6,
    "magnitude": 1.5,
    "balance": 2.33,
    "gradient": 0.5,
})
print(result.classification, result.confidence)

Authentication

Get your API key at garden.kongenlabs.life.

# Pass directly
client = KongenClient(api_key="kl_live_...")

# Or set environment variable
# export KONGEN_API_KEY=kl_live_...
client = KongenClient()

Batch Scoring

Score multiple signals at a discount (40 KT/signal instead of 50):

signals = [
    {"complexity": 0.7, "constraint": 0.3, ...},
    {"complexity": 0.5, "constraint": 0.6, ...},
    {"complexity": 0.9, "constraint": 0.1, ...},
]

results = client.transfer.score_batch(signals)
for r in results:
    print(f"{r.classification}: adj={r.confidence_adj:.3f}")

MCP Integration

Use the Kongen MCP server with LLM agents:

# List available tools
tools = client.mcp.list_tools()
# Returns: logic_score, transfer_score

# Call a tool
result = client.mcp.call_tool("logic_score", {
    "text": "Explain quantum entanglement"
})

Error Handling

from kongen import TokensExhaustedError, APIError

try:
    result = client.logic.score("...")
except TokensExhaustedError:
    print("Out of tokens -- add a payment method")
except APIError as e:
    print(f"API error {e.status_code}: {e.message}")

Token Usage

Every API call consumes Kongen Tokens (KT). Check your balance:

usage = client.token_usage
print(f"{usage.remaining} KT remaining")

Endpoint	Cost
logic.score()	1 KT ($0.0007)
transfer.score_signal()	50 KT ($0.035)
transfer.score_batch()	40 KT per signal ($0.028)
mcp.call_tool()	same as REST

Pricing

Pay-as-you-go. Every account gets 1,000 free Kongen Tokens on signup — no credit card required. Above the free allowance, each Kongen Token costs $0.0007. No subscriptions, no commitments. Billed monthly based on actual usage.

Enterprise customers can negotiate custom volume pricing -- contact [e-mail].

Documentation

• API Documentation
• Dashboard & API Keys
• Website
• Changelog

License

MIT -- see LICENSE for details.