Metadata-Version: 2.4
Name: stratasynth-cli
Version: 0.3.1
Summary: CLI for StrataSynth — synthetic conversational data with psychological depth
Project-URL: Homepage, https://stratasynth.com
Requires-Python: >=3.12
Requires-Dist: click>=8.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7.0
Description-Content-Type: text/markdown

# stratasynth-cli

Command-line interface for [StrataSynth](https://stratasynth.com) — the Synthetic Identity Engineering platform for generating psychologically grounded conversational data.

## Install

```bash
pip install stratasynth-cli
```

Requires Python 3.12+.

## Quick start

```bash
# Authenticate
stratasynth auth login --api-key ss_live_...

# Generate a dataset
stratasynth generate --scenario FAM-01 --count 100 --complexity 3

# Check job status
stratasynth jobs list
stratasynth jobs status <job-id>

# Generate a synthetic human (Humans Engine)
stratasynth humans generate \
  --demographics '{"age_range":"28-40","gender":"female","country":"ES"}' \
  --context '{"category":"skincare","study_brands":["CeraVe"]}'

# Run an interview
stratasynth humans interview --id hu_xxx --interview-style narrative --verbosity high

# Generate a batch of personas
stratasynth humans batch --count 10 --archetype working_mother

# Evaluate a completed job
stratasynth evaluate start --job-id <job-id>
stratasynth evaluate results --eval-id <eval-id>
```

## What is Synthetic Identity Engineering

Most synthetic personas break character under pressure. StrataSynth builds identities with persistent psychological cores — belief systems, defense mechanisms, and emotional regulation patterns — that produce coherent, differentiated behaviour across interaction contexts.

A system prompt describes a persona. Synthetic Identity Engineering builds one.

→ [Read the full definition](https://blog.stratasynth.com/synthetic-identity-engineering)

## Commands

| Command | Description |
|---|---|
| `stratasynth auth login` | Authenticate with your API key |
| `stratasynth generate` | Generate a conversation dataset |
| `stratasynth jobs list` | List your generation jobs |
| `stratasynth jobs status <id>` | Check job status |
| `stratasynth jobs download <id>` | Download completed dataset |
| `stratasynth personas generate` | Generate a persona profile |
| `stratasynth humans generate` | Create a synthetic human (Humans Engine) |
| `stratasynth humans batch` | Generate multiple synthetic humans |
| `stratasynth humans interview` | Start an interactive session |
| `stratasynth evaluate start` | Run evaluation on a job |
| `stratasynth evaluate results` | View evaluation metrics |
| `stratasynth scenarios list` | List available scenarios |

## Links

- Platform: [stratasynth.com](https://stratasynth.com)
- Documentation: [stratasynth.com/docs](https://stratasynth.com/docs)
- Public datasets: [huggingface.co/StrataSynth](https://huggingface.co/StrataSynth)
- Blog: [blog.stratasynth.com](https://blog.stratasynth.com)
