Metadata-Version: 2.4
Name: soren
Version: 0.0.3
Summary: Soren AI - Command-line interface for AI evaluation framework
Author: Soren Team
License-Expression: MIT
Project-URL: Homepage, https://github.com/soren-ai/soren-fieldguide
Project-URL: Documentation, https://github.com/soren-ai/soren-fieldguide
Project-URL: Repository, https://github.com/soren-ai/soren-fieldguide
Keywords: ai,evaluation,llm,testing,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# Soren CLI

Command-line interface for the Soren AI evaluation framework.

## Installation

```bash
pip install soren
```

## Usage

### Login

Authenticate with your Soren account:

```bash
soren login
```

You can also provide credentials directly:

```bash
soren login --email your@email.com --password yourpassword
```

### Run Evaluations

Create and run an evaluation:

```bash
soren run myproject --dataset mydataset --judge gpt-4
```

### Logout

Clear stored credentials:

```bash
soren logout
```

## Configuration

The CLI stores configuration in `~/.soren/config.json`, including:
- API key (for authentication)
- API URL (defaults to production)

## Environment Variables

- `SOREN_API_KEY`: Set your API key (alternative to `soren login`)
- `SOREN_API_URL`: Override the default API URL

## Development

To install from source:

```bash
pip install -e .
```

## License

MIT
