Metadata-Version: 2.5
Name: soup-harness
Version: 0.5.1
Summary: An idea harness that makes AI agents creative: frame, map the obvious, explore creative paths, critique, improve by value.
Author: Fabian von Tiedemann
License-Expression: Apache-2.0
License-File: LICENSE
License-File: LICENSE-CC-BY-4.0
License-File: NOTICE
Keywords: brainstorming,claude,creativity,ideation,llm,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Requires-Dist: anthropic<2,>=1
Requires-Dist: fastembed>=0.4
Requires-Dist: httpx>=0.27
Requires-Dist: huggingface-hub>=0.20
Requires-Dist: mcp<3,>=2.2
Requires-Dist: numpy>=1.26
Requires-Dist: pydantic>=2.7
Requires-Dist: pyyaml>=6.0
Provides-Extra: local-embeddings
Description-Content-Type: text/markdown

# Soup

An idea harness for Claude Code and Codex. Ask a real question in your repo and get a map of distinct, critiqued directions, stored as files in an idea bank next to your code. Soup runs a creative process around the model (creative paths, critique, improvement rounds, a final against a strong single call) instead of asking once.

## Getting started

You need [uv](https://docs.astral.sh/uv/) and Claude Code or Codex (signed in).

    cd your-repo
    uvx soup-harness init

Restart Claude Code or Codex in the repo and ask: *run Soup on: <your question>*. In Codex, trust the project first: Codex reads project config only in trusted projects. Commit `.mcp.json`, `.codex/config.toml` and the skills so your team runs the same version; Soup tells you when a newer one is out.

## Licence

Code and prompts (`soup/`): Apache 2.0. Seed libraries (`soup/seed_libraries`): CC BY 4.0. Copyright 2026 Fabian von Tiedemann.

<!-- changelog -->
# Changelog

## 0.5.1 (2026-10-05)

- Soup is on PyPI as `soup-harness`: run `uvx soup-harness init` in your repo.
- A repo's config pins a release; Soup tells you when a newer one is out, and `soup update` moves the pin.

## 0.5.0 (2026-10-05)

- Soup runs on GPT through Codex (`gpt-6.1-sol`, `gpt-6-astra`) and inside Codex.
- A run can mix Claude and GPT: both create ideas, one model leads and judges.
- The report shows which model's ideas reached the map and the top 3.

## 0.4.1 (2026-10-05)

- One critique call per idea and early-stopping duels: a standard run costs about a quarter less.

## 0.4.0 (2026-10-04)

- A fair duel between an improved idea and its parent, less convergence, and a second wave toward the paths that work.

## 0.3.0 (2026-10-03)

- Creative paths in the first round, value-directed improvement rounds, and depth per run.
