proserpina 0.3.0

Multi-agent critique and cross-examination pipeline for documents requiring intellectual rigor — provider-agnostic interaction-graph engine with pluggable LLM backends
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# Getting Started

## Install

```bash
cargo install proserpina
```

Or build from source:

```bash
git clone https://github.com/Industrial-Algebra/Proserpina
cd Proserpina
cargo install --path . --features cli,backend-http,json
```

## Authenticate one provider

The zero-config path: log in interactively.

```bash
proserpina auth login deepseek
```

This prompts for your API key, validates it, and stores it in
`~/.config/proserpina/credentials.toml` (or the OS keychain if the `keyring`
feature is on).

For OpenAI (ChatGPT), an OAuth browser flow is used:

```bash
proserpina auth login openai

# Or pin a specific model during login:
proserpina auth login openai --model gpt-5.5
```

Or set an env var directly (any of `DEEPSEEK_API_KEY`, `OPENAI_API_KEY`,
`MOONSHOT_API_KEY`, `DASHSCOPE_API_KEY`, `ZAI_API_KEY`, `GOOGLE_API_KEY`
works). If pi is installed, Proserpina auto-discovers pi's provider configs.

## Critique a document

```bash
proserpina critique roadmap.md
```

You'll get a markdown digest: an executive summary of findings by severity,
then each finding with its category, location, quote, suggested change, and
the critics that raised it.

## Try a multi-critic panel

```bash
proserpina critique roadmap.md --panel panel
```

`--panel panel` runs all five built-in critics (Devil's Advocate,
Methodologist, Red Team, Domain Expert, Editor), fanned across your authed
providers. The summarizer clusters their critiques — you'll see findings
"raised by" multiple critics where the panel converged.

## Exclude a provider

To temporarily disable a model from the roster (e.g. billing lapsed):

```bash
proserpina critique doc.md --exclude qwen3.7-max
```

Or persist the exclusion in `~/.config/proserpina/credentials.toml`:

```toml
exclude = ["qwen3.7-max", "mercury-2"]
```

## Reproduce or automate

```bash
# Reproduce a run exactly (the seed is printed in every report):
proserpina critique roadmap.md --seed 3

# Machine-readable output for piping into another tool:
proserpina critique roadmap.md --json

# See what a run would do without spending tokens:
proserpina critique roadmap.md --dry-run --seed 3
```

Next: [Providers and Credentials](./guide/providers.md) to set up multiple
providers and a credentials file.