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.7.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.7.0-py3-none-any.whl (19.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: janus_python_sdk-0.7.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.7.0.tar.gz
Algorithm Hash digest
SHA256 25bbfff7f5e14ad820ee341b16b1853cbb2a455e7543fd0bed99a4f65e4f9fb9
MD5 99806256804e0eb3083aac2e6463a9c3
BLAKE2b-256 6c4afd4f9e0041581403363649784830be97a1c9be44eab79a06cad12677ff4b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for janus_python_sdk-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 761dd0dec42444ec24d75b9b962a327b8aadffa0d628e7af4cf0d586e8b9783b
MD5 2cf38460db3a0fc3b37d2001a45c31d1
BLAKE2b-256 250a2b4e2f0724c2d0e30717b163bf927b761677be4ac37311fa85e15fe8e7e9

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