update vignette.html

Author: LYang-uva

.DS_Store

@@ -7935,18 +7935,62 @@ <h4 id="Assumptions-about-equipment-and-dependencies">Assumptions about equipmen
 </tr>
 <tr>
 <td><code>sentence_transformers</code></td>
-<td>Word embeddings for novelty / surprise</td>
+<td>Word embeddings for novelty / surprise (downloads <code>thenlper/gte-large</code> on first use)</td>
 </tr>
 <tr>
 <td><code>benepar</code></td>
-<td>Constituency parsing (optional pipeline extension)</td>
+<td>Constituency parsing (spaCy pipeline extension used by creativity scoring)</td>
+</tr>
+<tr>
+<td><code>numpy</code></td>
+<td>Numerical helpers in scoring</td>
+</tr>
+<tr>
+<td><code>streamlit</code></td>
+<td>Web UI (<code>streamlit_app.py</code>)</td>
+</tr>
+<tr>
+<td><code>altair</code></td>
+<td>Charts in the Streamlit app</td>
+</tr>
+</tbody>
+</table>
+<p><strong>Optional</strong> (<code>[project.optional-dependencies]</code>):</p>
+<table>
+<thead>
+<tr>
+<th>Package</th>
+<th>Role</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>pytest</code></td>
+<td>Unit tests (<code>pip install -e ".[dev]"</code>)</td>
+</tr>
+</tbody>
+</table>
+<p><strong>Vignette / notebook only</strong> (not in <code>pyproject.toml</code>; install if you run §3 plotting cells):</p>
+<table>
+<thead>
+<tr>
+<th>Package</th>
+<th>Role</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>matplotlib</code></td>
+<td>Example figures in this report</td>
 </tr>
 </tbody>
 </table>
 <p>Install from the repository root:</p>
 <div class="highlight"><pre><span></span>python<span class="w"> </span>-m<span class="w"> </span>venv<span class="w"> </span>.venv
 <span class="nb">source</span><span class="w"> </span>.venv/bin/activate<span class="w">          </span><span class="c1"># Windows: .venv\Scripts\activate</span>
-pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span><span class="s2">".[dev]"</span>
+pip<span class="w"> </span>install<span class="w"> </span>-e<span class="w"> </span><span class="s2">".[dev]"</span><span class="w">            </span><span class="c1"># package + pytest</span>
+<span class="c1"># Optional, for §3 matplotlib examples:</span>
+pip<span class="w"> </span>install<span class="w"> </span>matplotlib
 </pre></div>
 <h4 id="Scenario">Scenario<a class="anchor-link" href="#Scenario">¶</a></h4><blockquote>
 <p><em>A researcher is comparing two OpenRouter models on cognitive flexibility and creativity. They clone the miniBen repo, add their API key to <code>.env</code>, list available benchmarks from the terminal, then run the creativity benchmark for each model. miniBen makes five API calls per model, parses each story, computes per-call surprise and aggregate <code>avg_novelty</code>, and prints a summary they can paste into their lab report.</em></p>