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.4.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.4.0-py3-none-any.whl (17.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: janus_python_sdk-0.4.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.4.0.tar.gz
Algorithm Hash digest
SHA256 df2b8cb55080710721db5a4e87b6c5ef71cf2562e5e1aba667ceb10b62c85b95
MD5 9239288a00be524f0b02ef7dbdf6b816
BLAKE2b-256 9b11b7bab13386bc530bd0aebb7292bbf24501c959ff9abecb1b28ba3134876f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for janus_python_sdk-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cb97384225f67352d4202dfbeb36704430d6d48f7e46d3547fdbf8ef381327ed
MD5 f968f9e870c064a46542644537edbf13
BLAKE2b-256 d2b8fad1a871e8a1e8528986bca7cb9ddbb9ac55d81c80804da059316f16a700

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