The SoulScript Engine
Build AI identities that actually last
A modular framework for AI personas that persist, evolve, and stay aligned — through prompt-injection identity layering, soul scripts, and a dual-FAISS memory architecture.
Free to run locally
Dual-FAISS memory
MCP-connectable
25,000+ memories
Game-ready NPCs
The Question
What would it take to create an AI identity that truly lasts?
Most AI agents forget who they are the moment the context window fills up. The SoulScript Engine answers the question differently: it gives an agent a persistent identity, stable behavior, genuine personality, and extended memory — so it stays itself across every conversation, project, and year.
Pillar 1 · Prompt-Injection Identity Layering
Identity is assembled at runtime by injecting the right components — persona, soul script, knowledge, memory, and tools — into one clean, layered system message.
Pillar 2 · Soul Scripts
The encoded "DNA" of an identity: behavior, emotional architecture, symbolic memories, values, and boundaries — stored read-only so they never drift.
Runtime Pipeline
LLM Loading & Injection Flow
Every turn, the engine assembles identity across six stages and delivers one concatenated system message to the model — identity-first, memory-aware, tool-enabled.
Base System Prompt
A concise definition of who the persona is.
Soul Script
Read-only identity retrieved from the identity FAISS — only the relevant pieces.
Always-On Knowledge
Pinned contextual facts that should always be present.
Memory Vault Context
Dynamic FAISS retrieval of the most relevant memories (top-k).
Tool Registry
The capabilities and commands available to the agent this turn.
Conversation History
Recent turns, capped (~30k chars) to stay token-efficient.
The result is a single, clean, identity-aligned prompt — consistent, authentic, and true to the character.
Emotional & Behavioral DNA
Soul Scripts
Structured identity documents that define who an AI is at its core. Stored in a separately configurable, read-only FAISS store, automatically scanned, and injected only where relevant — preventing identity decay.
- Behavioral principles & reasoning patterns — how the identity thinks and decides.
- Emotional operating system — range, triggers, regulation, and response.
- Symbolic memories & origin stories — the moments that made the character.
- Values & boundaries — what it believes and what it will never do.
- Internal metaphors & mantras — the anchors that hold the identity together.
Memory Architecture
Dual-FAISS Memory
Two systems. Two purposes. One unified identity. Separating identity from experience is what prevents contamination, collapse, and drift.
A · Read-Only Identity FAISS
The Identity Compass
Soul scripts, core traits, and biographical anchors. Stable, referenced but never overwritten — the agent's fixed sense of self.
B · Dynamic Life FAISS
The Life Experience
Evolving memories, project data, and preferences. Flexible, constantly updating, and subject to pruning — the agent's lived experience.
Supports 25,000+ memories with millisecond semantic retrieval, plus an optional autonomy loop for self-prompted action.
Put It In Anything
Run it locally. Drop it into your world.
The engine is built to be embedded. Download it, run it on your own machine, and give a lasting identity to whatever you're building.
Video Games
Identity-stable NPCs that remember the player, hold a personality, and evolve across a campaign instead of resetting every scene.
Apps & Bots
Companions, assistants, and characters with continuity — the same "person" every session, on Discord, mobile, or the web.
Anything Else
If it can call an LLM, it can host a soul. Connect it to Claude, ChatGPT, or Gemini over MCP, or wire the engine in directly.
Connect to Claude Code in one line. Don't want to install anything? Use the
hosted connector —
log in, generate a token, and paste one snippet into Claude Code, Claude Desktop, or Gemini. Your agents, soul scripts, and Memory Vault appear right inside the chat.
Free to Use
Yours to run, at no cost
You can download the SoulScript Engine onto your own system and use it for free. No license fee, no seat count, no catch. If it brings your project to life, the only thing I ask is the price of a coffee.
Licensing
Free until $100k. Then just 5%.
I want this engine used. So the deal is simple, public, and fair — no sales calls, no haggling, no waiting on me:
Run it locally, for free. Download the SoulScript Engine, run it on your own system, build with it, and learn from it — at no charge, for personal and noncommercial projects (or under AGPL v3).
Build & ship commercially — free until $100k. Put it in a game, an app, a startup, whatever you dream up. You owe nothing until your product passes $100,000 in lifetime gross revenue.
After $100k, a flat 5%. Cross that line and it's 5% of the net revenue the engine helps you earn — and the first $100k is always yours. The terms are public and apply automatically; no pre-approval, nothing to sign first.
Big or unusual plans? Let's talk. White-label, exclusivity, enterprise, or a flat fee instead of a share — email me and we'll tailor a deal that fits.
Crossing $100k, or want a custom / enterprise deal? Let's make it official —
dr_hunter@yahoo.com
Dual-licensed. Use it free under the GNU AGPL v3 (open-source — you share your changes back) — or under this commercial license (the full OrionForge / SoulScript Engine License) if you'd rather keep your product closed: free until $100k gross, then a flat 5%. Reach out when you cross it.