Repository navigation
Home
A mirror, not a guru.
A reflective AI companion for deeper self-understanding, clearer perspective, and stronger self-trust.
SoulMap AI helps people explore their inner patterns, reflect on personal experiences, and discover their own meaning without surrendering their judgment to AI.
Explore the Repository → · Read the Core Doctrine → · View Documentation →
SoulMap is built around a simple principle: AI should help people understand themselves, not tell them who to be.
- Reflection over prescription — create space for insight rather than dictate decisions.
- Clarity over certainty — acknowledge ambiguity instead of pretending to have every answer.
- Personal agency over dependence — strengthen independent thinking, not reliance on AI.
- Meaning with discernment — distinguish psychological perspectives, spiritual traditions, personal beliefs, and hypotheses rather than presenting them as interchangeable facts.
Understand the purpose, scope, and direction of SoulMap AI.
Explore the principles that guide SoulMap's behavior, tone, and approach to reflection.
Learn how canonical Markdown knowledge informs runtime behavior, while Python handles parsing, normalization, routing, validation, and enforcement.
Find setup instructions and usage guidance before integrating SoulMap into your AI workflow.
Project Overview · Core Principles · Glossary
Architecture · Knowledge Architecture · Runtime Flow · Library vs Framework · Repository Structure
Safety and Boundaries · Safety Testing · Testing and Evaluation
Development Guide · Knowledge Authoring Guide · Contribution Guide · Build and Distribution
- ChatGPT conversation upload
- ChatGPT Custom GPT setup
- Gemini Gems setup
- Poe bot setup
- Claude.ai setup
The platform links point to the canonical integration guide in the source repository.
SoulMap aims to help people:
- Notice — recognize feelings, recurring patterns, and tensions.
- Explore — consider different perspectives without rushing to conclusions.
- Understand — connect experiences with possible meanings while respecting uncertainty.
- Choose — identify their own options and remain responsible for their decisions.
These are guiding principles, not a promise of a particular psychological or personal outcome.
SoulMap AI is a reflective companion, not a therapist, guru, diagnostic tool, or predictor of the future.
It does not replace professional care, trusted human support, or personal judgment. Psychological explanations, spiritual interpretations, cultural traditions, and speculative ideas should be distinguished clearly.
The goal is not to make people dependent on AI. It is to help them return to their own judgment with greater clarity.
Knowledge defines behavior. Python executes, normalizes, routes, validates, and enforces knowledge.
SoulMap follows a knowledge-first architecture: canonical Markdown defines semantic behavior, and the Python runtime applies that knowledge consistently.
For project discussions, bug reports, or contributions:
SoulMap AI — A mirror, not a guru. Reflection in service of human agency.
SoulMap AI — A reflective companion, not a guru.
Repository · Releases · Documentation
Knowledge defines behavior. Python executes, normalizes, routes, validates, and enforces knowledge.
SoulMap AI supports self-reflection without replacing personal judgment, professional care, or real-world support.