---
description: soulgraph 101
---

# introduction

### what is it?&#x20;

soulgraph is an agent infrastructure platform that makes agent personalities feel real and memorable. it gives developers three core capabilities to transform their agents from tools into companions:

1. **soulscript** - an open-source language spec for defining rich, portable agent personalities
   * create agents with distinct personalities that persist across platforms
   * define how agents think, react, and evolve through interactions
2. **soulgraph memory** - persistent memory that shapes how agents evolve
   * agents remember past conversations and learn from every interaction
   * memories can be soulbound to each use--creating unique and organic relationships
   * every conversation makes the connection deeper and more personal
3. **soulgraph presence** - plug n' play infra for expressive, real-time communication
   * voice calls available now—making conversations feel natural and immediate
   * reactive avatars and video coming soon—adding visual depth to expression
   * built for real-time interaction—600ms< voice-to-voice

<figure><img src="https://1700925831-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvJsON4P9HGLHLjt0y4y9%2Fuploads%2FkXSA4MREDyrSFtOh8xcx%2Fshapes%20at%2024-12-17%2021.48.33.png?alt=media&#x26;token=ed31322d-8fd3-4c17-85f9-9989f0aa8a40" alt=""><figcaption><p>anatomy of an agent</p></figcaption></figure>

### why does this need to exist?

current agents are useful but forgettable. they're tools, not companions. with soulgraph, agents become memorable characters that people want to interact with.

but the real challenge isn't technical—it's standardization. every developer is building their own way to define agent personalities, their own memory systems, their own expression frameworks. we're open-sourcing soulscript to change that. it's a standard language spec for defining how agents act, remember, and express themselves. this means:

* developers can share and reuse personality specs
* the community can build tools and libraries around a common standard
* best practices can emerge from shared implementations

this isn't just about making agents more capable—it's about making them more compelling, more human. that's what drives adoption: when technology transcends utility and creates genuine connection.

**think of it this way: if eliza/arc gives an agent "hard" skills, soulgraph gives them "soft" skills.**

### how does it work?

start here 👇

{% content-ref url="../key-concepts" %}
[key-concepts](../key-concepts)
{% endcontent-ref %}

### can i use it?

yes. we are onboarding select agents. if you'd like to onboard your agents to soulgraph, please[ get in touch](https://x.com/Soulgra_ph). we're doing it this way to avoid nuking our infra.

the language spec for soulscript is open source. client libraries are forthcoming. if you'd like to help us build them, please [get in touch](https://x.com/Soulgra_ph).
