---
title: Heretic Grimoire
emoji: ⚡
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 6.18.0
python_version: '3.13'
app_file: app.py
pinned: true
license: agpl-3.0
short_description: Archive for heretic generated models which are reproducible.
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/6842e3216b37355c08f9c00f/P4A9452Bw09L6JjU4_iYF.png
---

# Heretic Grimoire

<p align="center">
  <a href="https://huggingface.co/heretic-org">
    <img src="https://img.shields.io/badge/%F0%9F%A4%97-Hugging%20Face-orange?style=for-the-badge">
  </a>
  <a href="https://github.com/p-e-w/heretic">
    <img src="https://img.shields.io/badge/GitHub-Heretic-181717?style=for-the-badge&logo=github">
  </a>
  <a href="https://discord.gg/gdXc48gSyT">
    <img src="https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white">
  </a>
</p>

This app is for collecting and browsing public [Heretic](https://github.com/p-e-w/heretic) generated models' `reproduce.json` records. It runs the Heretic collector on a fixed twice-daily schedule and indexes any new records it finds. Collected records are kept as an archive, so previously saved data remains available even if the source repo later disappears. Collector logs are shown in the UI and cleared at the start of each collection run.

---

### Information

The app provides a searchable table of reproducibility metadata:

* `Heretic Model`
* `Base Model`
* `Created On`
* `Heretic Version`
* `KL`
* `Refusals`
* `Base Refusals`
* `Trials`
* `Accelerator`
* `JSON`

---

### Users can:

1. **Apply search filters**
1. **Refresh the visible table**
1. **Download the full archive as CSV.**

---

### Deploy

Persistent storage should be attached when deploying on Hugging Face Spaces so the archive survives restarts.

**Run locally with:**

```bash
python app.py
```