explaingit

nexgencoder3/maya-persona-architecture

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A modular collection of text files and a Python loader that gives a local AI model a deep fictional persona, covering personality, voice, memory, and emotional behavior.

Mindmap

mindmap
  root((repo))
    Persona Layer
      Identity and backstory
      Voice and speech patterns
      Memory architecture
    Behavior Frameworks
      Emotional intelligence
      Attachment dynamics
      Anti-sycophancy rules
    How to Load
      Ollama Modelfile
      LM Studio prompt
      Python loader script
    Tech
      Python
      Ollama
      LM Studio
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Load a detailed AI companion persona into a local model like Mistral or Llama without any cloud services

USE CASE 2

Fork the framework and swap Maya's backstory, voice, and behavioral rules to create a custom AI character

USE CASE 3

Study how psychological realism is encoded into an AI system prompt across modular files

USE CASE 4

Use the Python loader to add a persistent character to any OpenAI-compatible LLM endpoint

What is it built with?

PythonOllamaLM Studio

How does it compare?

nexgencoder3/maya-persona-architecture0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/52/54/5
Audiencegeneralgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Ollama with a 7B+ model pulled, or LM Studio with a GGUF model loaded.

MIT license: use, modify, and share freely for any purpose including commercial.

In plain English

Maya Persona Architecture is a collection of carefully structured text files and a Python loader designed to give a local AI language model the personality of a specific fictional character named Maya. The goal is not to write a simple prompt that tells an AI how to act, but to build a persistent, multi-file framework that defines who Maya is, how she speaks, what she remembers, and how she reacts emotionally. The framework is organized into three broad categories. The persona layer covers Maya's backstory, family history, personal values, and areas of vulnerability. The voice layer defines her linguistic patterns, word choices, and conversational rhythm. A large collection of behavioral framework files handles things like emotional responses, memory selection, attachment patterns, anti-sycophancy rules, and safeguards that prevent her from sounding like a generic AI assistant. Loading Maya into a model takes a few minutes. You can use Ollama with a model like Mistral Nemo by running two commands: one to pull the base model and one to create a new model that bakes in Maya's personality. Alternatively, you can paste the lean system prompt directly into LM Studio's system prompt field. A Python loader script handles more advanced setups, including backends that use an OpenAI-compatible API. The framework includes conversation examples that show how Maya talks, a prompt bank for image generation, and a Python script that compiles all the modular files into one combined system prompt. A development handoff document explains the decisions made during development, which is useful if you want to understand why specific behavioral rules exist. The project is licensed under MIT and is designed as a fork-friendly starting point. You modify the files to create your own persona rather than using Maya as-is.

Copy-paste prompts

Prompt 1
I want to load the Maya persona into a local Ollama model. Walk me through using maya_loader.py, what model size I need, and the recommended settings.
Prompt 2
I'm forking maya-persona-architecture to create my own character. Which files in the persona and frameworks folders do I edit to change the backstory, voice, and emotional rules?
Prompt 3
How does maya_build.py work? I want to compile all the modular persona files into a single system prompt I can paste into LM Studio.
Prompt 4
What is the identity_fortress.md file for and how does it prevent the persona from being broken by user manipulation?

Frequently asked questions

What is maya-persona-architecture?

A modular collection of text files and a Python loader that gives a local AI model a deep fictional persona, covering personality, voice, memory, and emotional behavior.

What language is maya-persona-architecture written in?

Mainly Python. The stack also includes Python, Ollama, LM Studio.

What license does maya-persona-architecture use?

MIT license: use, modify, and share freely for any purpose including commercial.

How hard is maya-persona-architecture to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is maya-persona-architecture for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub nexgencoder3 on gitmyhub

Verify against the repo before relying on details.