Skip to main content

Automatically stress-test your AI apps. Sign up for an api key at withjanus.com

Project description

Janus Python SDK Documentation

This repository contains the official documentation for the Janus Python SDK - a comprehensive AI agent simulation testing framework.

What is Janus?

Janus Python SDK helps you evaluate AI applications through automated simulations. It's designed to stress-test your AI agents with thousands of simulations, each testing different personalities, intents, and edge cases.

Quick Start

  1. Install the SDK:

    pip install janus-python-sdk
    
  2. Get an API Key: Contact team@withjanus.com

Eval Credits

Each simulation consumes one eval credit. When your account runs out, run_simulations / arun_simulations raise JanusCreditsExhaustedError with remaining, needed, and message attributes. Contact team@withjanus.com to top up. You can check your balance in the dashboard badge.

from janus_sdk import run_simulations, JanusCreditsExhaustedError

try:
    results = await run_simulations(num_simulations=10, max_turns=5, target_agent=my_factory, api_key="...")
except JanusCreditsExhaustedError as e:
    print(f"Out of credits: {e.remaining} left, needed {e.needed}. Email team@withjanus.com.")

Need Help?

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

janus_python_sdk-0.6.0.tar.gz (9.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

janus_python_sdk-0.6.0-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

File details

Details for the file janus_python_sdk-0.6.0.tar.gz.

File metadata

  • Download URL: janus_python_sdk-0.6.0.tar.gz
  • Upload date:
  • Size: 9.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.5

File hashes

Hashes for janus_python_sdk-0.6.0.tar.gz
Algorithm Hash digest
SHA256 df4cc042ef47e7df36d62c67170e2ea890641a3dc4726dcb31f15de8ecf50d9d
MD5 96f0b47e4e95949f220e68b6195eb8f6
BLAKE2b-256 e1a8469fac020af550afa552c21dcdac5f6dd933d59af6de00060abadd982f25

See more details on using hashes here.

File details

Details for the file janus_python_sdk-0.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for janus_python_sdk-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 09be1d69484feef2684d86197568c55650d1ce1a5807b4a24aa9d7bd415589bf
MD5 76ec103dd93c68464de9361b6d1ef008
BLAKE2b-256 cf30dbccfe717cafa6cbd5297e16fb965e7e6e0db4c210ea7bb46c02e1f115af

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page