SDK v2.0Production Ready

JustKalm SDKs

Enterprise-grade SDKs for Python, TypeScript, and mobile platforms. Build intelligent product analysis with health scoring, sustainability ratings, and AI-powered valuations.

Python SDK TypeScript SDK Mobile SDK API Reference

Key Features

Health Scoring

AI-powered health impact analysis based on materials and ingredients

Sustainability Ratings

Environmental impact scoring with material lifecycle analysis

Market Valuations

Real-time pricing intelligence with confidence scoring

Batch Processing

High-throughput operations for enterprise workloads

Enterprise Ready

Automatic Retries

Exponential backoff with jitter for reliable operations

Circuit Breaker

Resilience patterns to prevent cascading failures

Rate Limiting

Client-side throttling to prevent 429 errors

Webhook Security

HMAC-SHA256 signature verification for webhooks

Available SDKs

v2.0.0stable

Python SDK

Async-first Python SDK with full type hints. Ideal for backend services, data pipelines, and ML workflows.

pip install justkalm-sdk

View Documentation

v2.0.0stable

TypeScript SDK

Full TypeScript support for Node.js and browsers. React hooks included for seamless frontend integration.

npm install @justkalm/sdk

View Documentation

v2.0.0stable

Mobile SDK

Native SDKs for React Native, Flutter, iOS, and Android. Includes AR visualization and offline mode.

npm install @justkalm/react-native

View Documentation

Python Quick Start

quickstart.pypython

import asyncio
from justkalm import JustKalmClient, ProductCreateParams

async def main():
    async with JustKalmClient(api_key="jk_live_...") as client:
        # Create a product
        product = await client.products.create(ProductCreateParams(
            name="Organic Cotton T-Shirt",
            brand="EcoWear",
            category="apparel",
            materials={"organic_cotton": 0.95, "elastane": 0.05}
        ))
        
        # Get health valuation
        valuation = await client.valuations.create(product.id)
        
        print(f"Health Score: {valuation.health_score}/100")
        print(f"Value: ${valuation.adjusted_value:.2f}")

asyncio.run(main())

View full Python documentation

TypeScript Quick Start

quickstart.tstypescript

import { JustKalm } from '@justkalm/sdk';

const client = new JustKalm({
  apiKey: process.env.JUSTKALM_API_KEY!,
});

// Create a product
const product = await client.products.create({
  name: 'Organic Cotton T-Shirt',
  brand: 'EcoWear',
  category: 'apparel',
  materials: { organic_cotton: 0.95, elastane: 0.05 },
});

// Get health valuation
const valuation = await client.valuations.create(product.id, {
  includeHealth: true,
  includeSustainability: true,
});

console.log(`Health Score: ${valuation.healthScore}/100`);
console.log(`Value: $${valuation.adjustedValue.toFixed(2)}`);

View full TypeScript documentation

SDK Architecture

┌─────────────────────────────────────────────────────────────────┐
│                      Your Application                           │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │   Python    │  │ TypeScript  │  │   Mobile    │              │
│  │    SDK      │  │    SDK      │  │    SDK      │              │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘              │
│         │                │                │                     │
│  ┌──────┴────────────────┴────────────────┴──────┐              │
│  │              Unified SDK Layer                │              │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐          │              │
│  │  │ Retry   │ │ Circuit │ │  Rate   │          │              │
│  │  │ Handler │ │ Breaker │ │ Limiter │          │              │
│  │  └─────────┘ └─────────┘ └─────────┘          │              │
│  └──────────────────────┬────────────────────────┘              │
├─────────────────────────┼───────────────────────────────────────┤
│                         │                                       │
│              HTTPS/WSS  │  api.justkalm.com                     │
│                         ▼                                       │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │  Products   │  │ Valuations  │  │  Insights   │              │
│  │   Service   │  │   Engine    │  │   Engine    │              │
│  └─────────────┘  └─────────────┘  └─────────────┘              │
│                    JustKalm API                                 │
└─────────────────────────────────────────────────────────────────┘