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

Uploaded Python 3

File details

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

File metadata

  • Download URL: janus_python_sdk-0.5.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.5.0.tar.gz
Algorithm Hash digest
SHA256 d702fbfdac753e4508835afbc4c6f3e5bd641403dd588ba3beb9b1e65481e18d
MD5 e26bbddafaa61a8c7a13ff01c3655ed7
BLAKE2b-256 8374365f3da57a65d46e8ff5b5d81b238619a1cb2825e1608d0d72c203325f2a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for janus_python_sdk-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5644ab00d2c5a276d763801834adbe54472030b4d7cc1ccd8cda3ed02ed4fb40
MD5 13530c81d03ad4591cacd5e313d2f998
BLAKE2b-256 fec19fcc824ebfc622619d914d88aa69cf843cb1cf6a3cf9f50493714813496c

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