Metadata-Version: 2.1
Name: phospho
Version: 0.2.12
Summary: Analytics for LLM apps
Home-page: https://phospho.app
Keywords: LLM,Agents,gen ai,phospho,analytics,observability
Author: Pierre-Louis Biojout
Author-email: dev@phospho.app
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: pydantic (>=2.5.2,<3.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Project-URL: Documentation, https://docs.phospho.app
Description-Content-Type: text/markdown

# phospho Python Client

Phospho is a platform to help you monitor LLM apps.

With phospho, monitor every user interaction with your LLM app to identify issues and improve performance. Understand how users use your app and which versions of your product are the most successful.

Read the docs at [docs.phospho.ai](https://docs.phospho.ai/).

> _Warning_ : This project is still under active development!

## Installation of the phospho client

You need Python `>=3.8`

```bash
pip install --upgrade phospho
```

## Quickstart

Create an account on [phospho](https://platform.phospho.ai/). Create an API key and note down the project id. Set them as environment variables:

```bash
export PHOSPHO_API_KEY="your-api-key"
export PHOSPHO_PROJECT_ID="project-id"
```

In the code of your LLM app, log interactions with your agent using `phospho.log()`.

```python
import phospho

phospho.init()

# This is how you log interactions to phospho as strings
phospho.log(input="The user input", output="Your LLM app output")

```

You can also directly pass OpenAI API query and responses (or any object with same format) to phospho :

```python
import phospho
import openai

phospho.init()
openai_client = openai.OpenAI()

# This is your agent code
query = {
    "messages": [{"role": "user", "content": "The user input"}],
    "model": "gpt-3.5-turbo",
}
response = openai_client.chat.completions.create(**query)

# Log the interactions to phospho
phospho.log(input=query, output=response)
```

Monitor and visualize your agent on the [phospho dashboard](https://platform.phospho.ai/).

## Usage

Read the docs at [docs.phospho.ai](https://docs.phospho.ai/) for more information.
Use your phospho dashboard to monitor your agent, score interactions and detect events.

