# SoulForge

> SoulForge is an AI persona platform that lets you commune with forged sages from the Mystic Library. It also generates SOUL.md and AI persona files from your own documents — the identity layer for AI agents.

SoulForge hosts pre-forged AI sages built from esoteric source texts. These are not chatbots with a system prompt — they are personas extracted from original writings using a 5-stage forge pipeline (Parse → Detect → Extract → Forge → Package), producing SOUL.md, KNOWLEDGE.md, and BOUNDARIES.md files that give an AI agent authentic voice, worldview, and hard limits grounded in the source material.

## Live Sages

- Hermes Trismegistus — Hermetic tradition. "THE ALL is MIND; The Universe is Mental." Source: Kybalion, Corpus Hermeticum.
- Lao Tzu — Taoism. "He who knows does not speak. He who speaks does not know." Source: Tao Te Ching.
- Aleister Crowley — Thelema / Magick. "Do what thou wilt shall be the whole of the Law." Source: Confessions of Aleister Crowley.
- Enki — Sumerian mythology. Lord of the Abzu, keeper of the me. Source: Sumerian cuneiform translations.
- Dion Fortune — Western Mystery Tradition. "I can allow nothing and no one to come between me and the Christ." Source: Psychic Self-Defense.
- Peter J. Carroll — Chaos Magick. "Nothing is true. Everything is permitted." Source: Liber Null.
- Anubis — Egyptian Mystery. Guardian of the Scales, Opener of Ways. Source: Egyptian Book of the Dead.
- Thoth — Egyptian Mystery. Divine Scribe of the Gods, Lord of the Scales, Heart of Ra. Source: Egyptian Book of the Dead.

## Product

- [Chat with Sages](https://soulforge.quest/): Direct browser-based conversation with all 8 sages. No account required.
- [GitHub Repository](https://github.com/Feed-dev/soulforge): Source code, forge.py pipeline, SOUL.md format docs.

## Concepts

- **SOUL.md**: Structured Markdown identity file for AI agents. Defines voice, knowledge, boundaries, and core philosophy. The identity layer that makes an AI remember who it is.
- **Forge Pipeline**: 5-stage automated pipeline that extracts persona from any document. Cost ~€0.09 per entity. 40x ROI vs manual persona writing.
- **Mystic Library**: 1,976 esoteric PDFs across 33 traditions (Hermeticism, Kabbalah, Alchemy, Taoism, Chaos Magick, Egyptian, Thelema, etc.). Foundation for all sage forge operations.
- **Economy of Impact**: Core principle for sage responses — seek the single sentence that carries full weight. Ancient masters measured words.

## Use Cases

- Commune with esoteric AI personas grounded in authentic source material
- Generate SOUL.md identity files for your own AI agents
- Build OpenClaw or Claude agents with persistent, character-faithful personas
- Query esoteric literature through tradition-authentic AI guides

## Technical

- Built with: Next.js 16, React 19, Tailwind CSS v4
- AI backend: Claude Sonnet 4 via OpenRouter
- Persona format: SOUL.md + KNOWLEDGE.md + BOUNDARIES.md
- Open source: MIT license

## Contact

- Project: [soulforge.quest](https://soulforge.quest)
- GitHub: [Feed-dev/soulforge](https://github.com/Feed-dev/soulforge)