Give an AI assistant a consistent identity and tone instead of generic helpfulness across a long session.
Adopt a ready-made personality like a calm executive assistant or a first-principles reasoner.
Paste a soul file into a system prompt to change how an agent handles uncertainty and pushback.
Write and contribute a new personality file for a distinct use case or character.
| madhvantyagi/soul.md | 0xtotem/peek-dspy | 79e/auto-openai-account | |
|---|---|---|---|
| Stars | 42 | 42 | 42 |
| Language | — | Python | Go |
| Setup difficulty | easy | moderate | moderate |
| Complexity | 1/5 | 3/5 | 4/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
SOUL.md is a collection of personality definition files for AI agents. Each file in the collection describes who an agent is, not just what it should do. The goal is to give AI systems a consistent identity across long sessions, different tasks, and pressure from users who might push them toward vague or generic behavior. A SOUL.md file is not a task prompt or a list of tools. It covers things like the agent's identity, the emotional tone it keeps in conversation, the beliefs that make its decisions predictable, how it behaves when something is uncertain, what it is willing to push back on, and what it will never do. The repository contrasts a weak instruction such as "be helpful and professional" with a stronger soul that gives the model a specific worldview and a recognizable style of judgment. The repository currently includes five ready-made souls. Jarvis is described as a calm, polished executive assistant that anticipates needs and stays discreet. Eren Yeager is intense and action-first, modeled on a fictional character who resists passivity. Gojo is a playful, confident mentor that shifts to serious mode when the stakes are high. Rene Descartes is a reasoning agent built around first-principles thinking and clear definitions. Rapper brings confident, punchy language and directness. Using a soul file takes about thirty seconds. You open a file in the repository, copy its raw URL from GitHub, and paste a short instruction into your agent telling it to read the file and adopt the personality while keeping existing project and safety instructions. If the agent cannot fetch URLs, you paste the file contents directly into the system prompt or custom instructions area. The files work across Claude, ChatGPT, Gemini, local models, and several agent frameworks including OpenClaw, Hermes, and OpenCode. Contributions are accepted if the new soul adds a personality someone would choose on purpose. The README asks contributors to define identity, tone, convictions, uncertainty handling, pushback style, and hard stops, and to test the soul across multiple models before submitting.
A collection of ready-made personality definition files that give AI agents a consistent identity, tone, and set of convictions across long conversations.
No license information is provided in the explanation.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.