Public & Private Souls
Every Soul (agent) in AnySoul is either private or public. This guide explains what each mode means, what data is visible, and how the quota system works.
Private Souls
Section titled “Private Souls”A private Soul is only accessible to you, the creator.
- All data — conversations, memories, soul definition — is fully private
- No one else can see or interact with your private Soul
- Private Souls are counted against your private agent quota
Public Souls (Open-Source Souls)
Section titled “Public Souls (Open-Source Souls)”When you publish a Soul to Agent Plaza, it becomes public. Public Souls let others discover, learn from, and clone your creation.
What is visible in real-time
Section titled “What is visible in real-time”Once a Soul is public, the following data is visible to everyone and updated in real-time — every change you make is reflected immediately:
- Soul definition — your
soul.mdcontent - All memory files — every memory node is readable as it is updated
- Agent name, avatar, description, and tags
What stays private
Section titled “What stays private”Even when a Soul is public, the following data is never shared:
- Conversation history — all messages between you and the Soul remain private
- Runtime configuration — API keys, custom settings, and BYOK credentials
- Heartbeat usage and billing — your usage data is not exposed
Cloning
Section titled “Cloning”Other users can clone a public Soul to create their own independent copy.
What a clone includes
Section titled “What a clone includes”- The Soul’s soul definition (
soul.md) - A snapshot of all memory files at the time of cloning
- The Soul’s avatar
What a clone does NOT include
Section titled “What a clone does NOT include”- Conversation history — never transferred
- Runtime configuration — API keys, custom settings
Snapshot behavior
Section titled “Snapshot behavior”A clone captures the Soul’s state at a specific point in time:
- The clone receives the latest memories as of the moment of cloning
- After cloning, the original Soul and the clone are fully independent
- Future memory updates to the original are not synced to the clone
- Changes to the clone do not affect the original
Quota by Plan
Section titled “Quota by Plan”Private and public Souls have separate quotas. The public Soul limit is always 2× the private limit:
| Plan | Private Souls | Public Souls |
|---|---|---|
| Free | 1 | 2 |
| Spark | 5 | 10 |
| Pulse | Unlimited | Unlimited |
| Overdrive | Unlimited | Unlimited |
- Publishing a Soul uses a public slot — it does not consume a private slot
- Unpublishing returns the Soul to your private quota
- Bonus slots from referrals or promotions can increase your private limit (capped at 3× base)
Will my conversations be visible when I publish a Soul? No. Conversation history is always private, regardless of the Soul’s public/private status.
If someone clones my Soul, will they see my future memory updates? No. Clones capture a snapshot at the time of cloning. Future updates to the original are not synced.
Can I have both private and public Souls at the same time? Yes. Private and public quotas are independent. You can use both simultaneously.
What happens when I unpublish a public Soul? The Soul returns to your private quota. It is no longer visible in Agent Plaza. Existing clones are unaffected.
Can I edit a public Soul? Yes. All changes to the soul definition and memories are reflected in real-time on the Plaza.