Skip to main content

Overview

athina-evals is an framework to help you quickly set up evaluations and monitoring for your LLM-powered application

It's difficult to know if your LLM response is good or bad. Most developers start out by simply eyeballing the responses. This is fine when you're building a prototype and testing on 5-10 examples.

But once you optimize for reliability in production, this method breaks down.

Evals can help you:

  • Detect regressions
  • Measure performance of model (as defined by your goals)
  • A/B test different models and prompts rapidly
  • Monitor production data with confidence
  • Run quantifiable experiments against ambiguous conversations

Think of evals like unit tests for your LLM app.

Documentation

See https://docs.athina.ai for the complete documentation.

Quick Start

1. Install the package

pip install athina-evals

2. Get an Athina API key

Sign up at athina.ai to get an API key.

(free, and only takes about 30 seconds)

3. Set API keys

from athina.keys import AthinaApiKey, OpenAiApiKey

OpenAiApiKey.set_key(os.getenv('OPENAI_API_KEY'))
AthinaApiKey.set_key(os.getenv('ATHINA_API_KEY'))

4. Run evals

# Load the data from CSV, JSON, Athina or Dictionary
dataset = RagLoader().load_json(json_file)

# Run the DoesResponseAnswerQuery evaluator on the dataset
DoesResponseAnswerQuery().run_batch(data=dataset)



Why should I use Athina's Evals instead of writing my own?

You could build your own eval system from scratch, but here's why Athina might be better for you:

  • Athina provides you with plug-and-play preset evals that have been well-tested
  • Athina evals can run on both development and production, giving you consistent metrics for evaluating model performance and drift.
  • Athina removes the need for your team to write boilerplate loaders, implement LLMs, normalize data formats, etc
  • Athina offers a modular, extensible framework for writing and running evals
  • Athina calculate analytics like pass rate and flakiness, and allows you to batch run evals against live production data or dev datasets

Athina Evals Platform

Need Production Monitoring and Evals? We've got you covered...

  • Athina eval runs automatically write into Athina Dashboard, so you can view results and analytics in a beautiful UI.
  • Athina track your experiments automatically, so you can view a historical record of previous eval runs.
  • Athina calculates analytics segmented at every level possible, so you can view and compare your model performance at very granular levels.

Athina Observe Platform

About Athina

Athina is building an end-to-end LLM monitoring and evaluation platform.

Website | Demo Video

Contact us at hello@athina.ai for any questions about the eval library.

Metadata

Release files for athina-evals 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for athina-evals 0.0.3
File Size Uploaded
athina_evals-0.0.3.tar.gz 19.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for athina-evals 0.0.3
File Interpreter ABI Platform
athina_evals-0.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 49.6 kB

Release files / athina_evals-0.0.3.tar.gz

Download URL athina_evals-0.0.3.tar.gz
Size 19.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a64adbafac9040c096147b26d18a136fd14effc3c2e5c32344287d3b05e99f27
BLAKE2b-256 checksum
How to use checksums
5e47fd0f73e2f03d7d5ded5717916537a46e167527785203ec21efdbe578bbf5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.6.1 CPython/3.9.16 Darwin/23.0.0

Release files / athina_evals-0.0.3-py3-none-any.whl

Download URL athina_evals-0.0.3-py3-none-any.whl
Size 30.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
82cc04c664143472b81439356e6a47ed41c3f394ca22e5ad6dc7a98d83add2b6
BLAKE2b-256 checksum
How to use checksums
4debf1ca2e83023938b76819dbda65f96ca8431e2e9c79e471fea60e13df775d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.6.1 CPython/3.9.16 Darwin/23.0.0

Release history Release notifications | RSS feed

This release

0.0.3 This release

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page