# The Grimoire — Occult Text Semantic Search

> A searchable library of 8,334 primary source occult, esoteric, and magical texts spanning 27 traditions from antiquity to the modern era.

## API

Search endpoint: GET /api/v1/search?q={query}&page=1&pageSize=10&tradition={tradition}

Returns semantic search results ranked by cosine similarity over 1.18M text chunks embedded with nomic-embed-text-v1.5.

### Parameters
- q (required): natural language search query
- page (optional, default 1): page number
- pageSize (optional, default 10, max 50): results per page
- tradition (optional): filter by tradition (e.g. alchemy, grimoire, kabbalah)

### Available Traditions
kabbalah, alchemy, grimoire, hermetic, gnostic, rosicrucian, thelema, enochian, egyptian-magic, mesopotamian-magic, greco-egyptian-magic, astral-magic, neoplatonic, occult-general, freemasonry, witchcraft, renaissance-magic, mysticism, divination, theosophy, islamic-esoteric, christian-esoteric, angelology, eastern, ancient-near-east

### Response Format
```json
{
  "results": [
    {
      "chunk_id": "string",
      "doc_id": "string",
      "title": "string",
      "author": "string",
      "tradition": "string",
      "chapter": "string",
      "score": 0.85,
      "snippet": "text preview..."
    }
  ],
  "total": 1186247,
  "page": 1,
  "pageSize": 10,
  "query": "your query",
  "dataset": "https://huggingface.co/datasets/ebrinz/text-cult"
}
```

## Data

Full corpus available as open data:
- HuggingFace Dataset: https://huggingface.co/datasets/ebrinz/text-cult
- Format: Parquet with columns: id, text, title, author, tradition, source, source_url, language, file_type, ocr_used, char_count
- 8,334 documents, 1.45B characters
- Sources: Sacred Texts, Internet Archive, Project Gutenberg, Hermetic Library, Esoteric Archives

## Sources Include
- Greek Magical Papyri (PGM) — Betz translation
- Corpus Hermeticum, Asclepius, Divine Pymander
- Key of Solomon, Lemegeton, Grimorium Verum, Grand Grimoire
- Agrippa's Three Books of Occult Philosophy
- Giordano Bruno's magical works
- John Dee's Enochian texts
- Aleister Crowley's complete Libers and major works
- Picatrix (Ghayat al-Hakim)
- Egyptian Book of the Dead, Coffin Texts, Demotic Magical Papyrus
- Maqlu tablets, Babylonian magical texts
- Nag Hammadi library, Pistis Sophia
- Sepher Yetzirah, Sword of Moses
- And thousands more