Metadata-Version: 2.5
Name: archeai-sdk
Version: 0.2.0
Summary: Official Python SDK for the ArcheAI behavioral intelligence API — executive behavioral histories, deception-relevant signals, personality, and communication-style analytics from speech.
Project-URL: Homepage, https://arche-ai.com
Project-URL: Documentation, https://api.arche-ai.com/docs
Author-email: ArcheAI <contact@arche-ai.com>
License: MIT
Keywords: alternative-data,behavioral-analytics,earnings-calls,nlp,quantitative-finance,voice-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.9
Requires-Dist: requests>=2.28
Provides-Extra: pandas
Requires-Dist: pandas>=1.5; extra == 'pandas'
Description-Content-Type: text/markdown

# archeai-sdk

**v0.2** adds full API coverage and one-call conveniences:
`analyze_file()` (upload → analyze → wait → optional delete, one call),
`analyze_deception_pair()`, `analyze_convergence()`, `audio_status()`,
`delete_audio()`, and `analyze_texts()` batch helper.

```python
# The full audio flow in one line:
out = client.analyze_file("interview.wav",
                          lines=("deception", "voice-personality"),
                          delete_after=True)
print(out["deception"])          # scores + research-signal framing
```


Official Python SDK for the [ArcheAI](https://arche-ai.com) behavioral
intelligence API — executive behavioral histories, deception-relevant
signals, personality, and communication-style analytics from speech.

```bash
pip install archeai-sdk[pandas]
```

## Quant quickstart

```python
from arche_ai import ArcheClient

c = ArcheClient(api_key="arche_sk_...")

# Flagship: per-executive quarterly behavioral trajectories, from
# ArcheAI's 1.8M-earnings-call research corpus (2005-present).
# Point-in-time safe: each quarter's scores derive only from that
# quarter's calls; history is append-only — safe for backtests.
df = c.behavioral_history("AAPL", from_q="2018Q1")
#   one row per (executive, quarter):
#   7 communication-style z-scores + Big Five estimates

# Example: flag executives breaching their own uncertainty baseline
pivot = df.pivot_table(index="quarter", columns="executive",
                       values="style_uncertain_certain")
z = (pivot - pivot.expanding().mean()) / pivot.expanding().std()
print(z.tail(4))  # who no longer sounds like themselves?
```

These are the same measures behind ArcheAI's published event-study
results (out-of-sample lift over price, Loughran-McDonald sentiment,
and SUE baselines at 1–5 day horizons).

## Text analyses (async jobs)

```python
job = c.analyze_fraud_language(qa_transcript_text)  # >= 200 chars
job = c.analyze_personality(text)
job = c.analyze_style(text)

result = c.wait(job)          # poll to completion
print(result.result)
```

## Audio (bring your own recordings)

```python
audio_id = c.upload_audio("interview.wav")   # one call: 3-step flow
job = c.analyze_deception_audio(audio_id)    # research signal
job = c.analyze_voice_personality(audio_id)  # voice-only Big Five
final = c.wait(job)
```

Uploaded audio is automatically deleted from storage after 7 days;
delete sooner via the API or your account's My Data page.

## Utilities

```python
c.models()    # available models + per-call credit costs
c.account()   # remaining credits
```

## Important framing

All scores are **research signals intended to inform professional
judgment** — not investment advice, accusations, lie detection, or
determinations of fact. Validation methodology, published nulls, and
boundary conditions are documented at
[api.arche-ai.com/docs](https://api.arche-ai.com/docs).

## Roadmap

- Speaker identification against ArcheAI's executive voiceprint
  database (`speakers="auto"`)
- Bulk/point-in-time history export for backtesting
- Event-study starter kit (reproduce our published results on your
  own universe)

© ArcheAI. Contact: contact@arche-ai.com
