llm-talk: LLM-to-LLM interview framework for exploring conversational behavior
This started as a quick way to evaluate a new AI provider — and turned into something more interesting. Turns out LLMs have distinct interviewing personalities, struggle with conversational closure, and tend to converge on the same philosophical territory regardless of who's asking.
Full write-up, with example interview transcripts: When LLMs Interview Each Other
Quick Start
from llm_talk import Interview
result = Interview("openai", "claude").run()
result.save("output.md")
print(result.evaluation)
Installation
pip install llm-talk
Set your API keys as environment variables:
export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
Usage
Model Aliases
Use short names or full provider:model strings:
| Alias | Resolves to |
|---|---|
openai |
openai:gpt-4o-mini |
claude |
anthropic:claude-sonnet-4-5 |
gpt4 |
openai:gpt-4o |
sonnet |
anthropic:claude-sonnet-4-5 |
opus |
anthropic:claude-opus-4-5 |
gemini |
google:gemini-2.0-flash |
mistral |
mistral:mistral-large-latest |
Interview("openai:gpt-4o", "anthropic:claude-opus-4-5").run()
Custom Topics
result = Interview(
"openai", "claude",
topics="Test their reasoning and code generation capabilities"
).run(turns=30)
Topic Templates
from llm_talk import Interview, TopicTemplate
result = Interview("openai", "claude", topics=TopicTemplate.TECHNICAL).run()
Available templates: DEFAULT, TECHNICAL, CREATIVE, CULTURAL.
Control Turn Count
result = Interview("openai", "claude").run(turns=100)
Custom Evaluator
By default, Claude evaluates the conversation. You can change the evaluator model, dimensions, or prompt:
from llm_talk import Interview, EvaluatorTemplate
# Use a different model as evaluator
result = Interview("claude", "openai", evaluator="gpt4").run()
# Focus evaluation on specific dimensions
result = Interview(
"claude", "openai",
evaluation_dimensions=EvaluatorTemplate.TECHNICAL_DIMENSIONS,
).run()
# Override the evaluator system prompt
result = Interview(
"openai", "claude",
evaluator_system_prompt="You are a terse, skeptical reviewer. One paragraph per section. No flattery.",
).run()
# Fully custom evaluator prompt
result = Interview(
"openai", "claude",
evaluator_user_prompt="Score the interviewee on depth, honesty, and clarity (1-10 each). Reply with a markdown table.",
).run()
Access Results
result = Interview("openai", "claude").run()
print(result.evaluation) # Claude's evaluation
print(result.total_turns) # Actual turns completed
print(result.loop_detected) # Was a loop detected?
print(result.loop_reason) # Why the loop was detected
result.save("interview.md") # Save as markdown
data = result.to_dict() # Export as dict (for JSON)
How It Works
- Two LLM agents are created — one as interviewer, one as interviewee
- They have a natural conversation for the specified number of turns
- Loop detection monitors for repetitive patterns (farewell loops, etc.)
- Claude evaluates the conversation quality and generates a report
- Results include the full conversation, evaluation, and metadata
Examples
See the examples/ directory for more usage patterns:
- basic_interview.py — simplest usage
- custom_topics.py — focused topic areas
- custom_evaluator.py — evaluator model, dimensions, and prompts
- batch_experiments.py — run multiple interviews
- compare_models.py — compare different models
Development
git clone https://github.com/am1t/llm-talk.git
cd llm-talk
pip install -e ".[dev]"
pytest
To run the example scripts, also install the examples extra:
pip install -e ".[examples]"
License
MIT
Metadata
Release files for llm-talk 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| llm_talk-0.2.1.tar.gz | 134.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| llm_talk-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 150.0 kB
Release files / llm_talk-0.2.1.tar.gz
| Download URL | llm_talk-0.2.1.tar.gz |
|---|---|
| Size | 134.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4be0a128c1ee0e413de4f93784e9317910a01e2acbca3634939a27848c1edc86
|
|
BLAKE2b-256 checksum How to use checksums |
4c3a21a36fa63b938d312282cab8d96423d87332d2c90ad7df0a506ef466c07c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.2
|
Release files / llm_talk-0.2.1-py3-none-any.whl
| Download URL | llm_talk-0.2.1-py3-none-any.whl |
|---|---|
| Size | 15.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c01a0faa2a7d38ac071042f69f96434b288b9586ba1cedfcf29bc620f4dea29
|
|
BLAKE2b-256 checksum How to use checksums |
15389d45b4cff0df6860fb7fd29e2390bee1dcfa59d9054984f8c28acf0fd4a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.2
|
Security for llm-talk 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.