> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory-capy-add-llmstxt-summary-and.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# What is Supermemory?

> Supermemory is the long term and short term context and memory infrastructure for agents.

export const ArtTile = ({title, href, art, pos = "center", flip, children}) => {
  return <a className="sm-card sm-art-card group" href={href}>
      <div className="sm-card-media sm-art-media">
        <img src={art} alt="" style={{
    objectPosition: pos,
    "--flip": flip ? -1 : 1
  }} />
        <div className="sm-art-wash" />
        <div className="sm-scene" aria-hidden="true">{children}</div>
      </div>
      <div className="sm-card-body">
        <div className="sm-card-title">
          <span>{title}</span>
          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"><path d="M5 12h14M13 6l6 6-6 6" /></svg>
        </div>
      </div>
    </a>;
};

export const At = ({x, y, w, className, children}) => <div className={className} style={{
  left: x,
  top: y,
  width: w
}}>{children}</div>;

export const Tile = ({x, y, size = 36, src, icon, logo, on, faded, badge}) => <div className={"m m-tile" + (src ? logo ? " is-logo" : " is-app" : "") + (on ? " is-on" : "") + (faded ? " is-faded" : "")} style={{
  left: x,
  top: y,
  width: size,
  height: size,
  padding: logo ? Math.round(size * 0.22) : 0
}}>
    {src ? <img src={src} alt="" /> : <Icon icon={icon} size={Math.round(size * 0.45)} />}
    {badge ? <span className="m-badge"><Icon icon="/icons/hugeicons/tick-02.svg" size={9} /></span> : null}
  </div>;

export const Lines = ({d}) => <svg className="m-lines" viewBox="0 0 264 152" aria-hidden="true">
    {d.map(path => <path key={path} d={path} />)}
  </svg>;

Supermemory is **context infrastructure for AI agents**. It gives your agent memory, retrieval and user profiles through one API, and you can configure each part for your use case.

These are the building blocks it ships with:

<div className="not-prose sm-art-grid">
  <ArtTile title="Memory & continual learning" href="/concepts/graph-memory" art="/images/art/bg-branch.jpg" pos="center">
    <At x={48} y={8} w={168} className="m m-card m-row is-faded is-back"><span className="m-ic"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/source-code.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=52683783392468c7c21576fea4b14c15" size={12} width="24" height="24" data-path="icons/hugeicons/source-code.svg" /></span><s>Prefers Python</s></At>
    <At x={32} y={38} w={200} className="m m-card m-row is-front"><span className="m-ic is-on"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/refresh.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=90c3bd52a81557fa3e8a77026079e5f5" size={12} width="24" height="24" data-path="icons/hugeicons/refresh.svg" /></span><span className="m-grow">Uses TypeScript</span><span className="m-tag">Updates</span></At>

    <Lines d={["M132 82 L 132 104"]} />

    <At x={76} y={104} className="m m-chip"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/plus-sign.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=e61184a2a5a45db092cdb1945c0c97c0" size={11} width="24" height="24" data-path="icons/hugeicons/plus-sign.svg" />Bun for scripts</At>
  </ArtTile>

  <ArtTile title="SuperRAG (retrieval)" href="/concepts/super-rag" art="/images/art/bg-meadow.jpg" pos="center">
    <At x={24} y={14} w={216} className="m m-card m-row m-search"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/search-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=c99db8ae4145ac800d41acbbbb254aba" size={13} width="24" height="24" data-path="icons/hugeicons/search-01.svg" /><span className="m-grow">refund policy for annual plans</span></At>

    <At x={56} y={94} w={152} className="m m-card m-ghost is-faded" />

    <At x={44} y={82} w={176} className="m m-card m-ghost is-faded" />

    <At x={32} y={66} w={200} className="m m-card m-row is-front"><span className="m-ic is-on"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/file-02.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=747f4b7c2718cb678673271f26a315a4" size={12} width="24" height="24" data-path="icons/hugeicons/file-02.svg" /></span><span className="m-grow"><span className="m-skel" style={{ width: "88%" }} /><span className="m-skel" style={{ width: "56%" }} /></span><span className="m-score">0.92</span></At>
  </ArtTile>

  <ArtTile title="Filesystems" href="/smfs/overview" art="/images/art/bg-stream.jpg" pos="center">
    <At x={21} y={38} className="m-folder">
      <span className="m-folder-front">
        <img src="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/RZUchfWXNk8FOiN_/images/art/mark-white.svg?fit=max&auto=format&n=RZUchfWXNk8FOiN_&q=85&s=4bb941a31262483ee7e8f672b5322ea5" alt="" width="206" height="168" data-path="images/art/mark-white.svg" />
      </span>
    </At>

    <Lines d={["M111 74 L 131 74"]} />

    <At x={135} y={26} w={108} className="m m-card m-files">
      <div className="m-file is-on"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/file-02.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=747f4b7c2718cb678673271f26a315a4" size={12} width="24" height="24" data-path="icons/hugeicons/file-02.svg" /><span>profile.md</span></div>
      <div className="m-file"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/file-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=d207c197e87154c8ee2a24240bfa9f13" size={12} width="24" height="24" data-path="icons/hugeicons/file-01.svg" /><span>notes.md</span></div>
      <div className="m-file"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/folder-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=d533387aff4328cae4e17d17fdb1674f" size={12} width="24" height="24" data-path="icons/hugeicons/folder-01.svg" /><span>meetings</span></div>
    </At>
  </ArtTile>

  <ArtTile title="Profiles" href="/concepts/user-profiles" art="/images/art/bg-grass.jpg" pos="center">
    <At x={24} y={30} w={216} className="m m-card m-profile">
      <div className="m-profile-head">
        <span className="m-avatar">
          <img src="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/RZUchfWXNk8FOiN_/images/art/maya.jpg?fit=max&auto=format&n=RZUchfWXNk8FOiN_&q=85&s=4c013e8a9e1c81b4c07e301e99c18454" alt="" width="160" height="160" data-path="images/art/maya.jpg" />
        </span>

        <span className="m-grow"><b>Maya Kapoor</b><span>Payments engineer</span></span>
      </div>

      <div className="m-fact"><span className="m-ic"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/location-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=70bce84f8dc21c46af55aa6a6bcb6458" size={11} width="24" height="24" data-path="icons/hugeicons/location-01.svg" /></span><span className="m-grow">Based in Berlin</span><span className="m-fact-kind">Static</span></div>
      <div className="m-fact"><span className="m-ic is-on"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/flash.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=3cb7e337be4be7f18dd98e01022d8ae4" size={11} width="24" height="24" data-path="icons/hugeicons/flash.svg" /></span><span className="m-grow">Fixing webhooks</span><span className="m-tag">Dynamic</span></div>
    </At>
  </ArtTile>

  <ArtTile title="Connectors" href="/connectors/overview" art="/images/art/bg-lakeshore.jpg" pos="center">
    <Lines d={["M78 30 C 130 30, 140 76, 176 76", "M78 76 L 176 76", "M78 122 C 130 122, 140 76, 176 76"]} />

    <Tile x={36} y={10} size={40} src="/images/notion-icon.svg" logo />

    <Tile x={36} y={56} size={40} src="/images/google-drive-icon.svg" logo />

    <Tile x={36} y={102} size={40} src="/images/github-icon.svg" logo />

    <At x={176} y={50} className="m-orb is-hub">
      <img src="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/RZUchfWXNk8FOiN_/images/art/mark-white.svg?fit=max&auto=format&n=RZUchfWXNk8FOiN_&q=85&s=4bb941a31262483ee7e8f672b5322ea5" alt="" width="206" height="168" data-path="images/art/mark-white.svg" />
    </At>
  </ArtTile>

  <ArtTile title="Extractors" href="/concepts/content-types" art="/images/art/bg-islands.jpg" pos="center">
    <At x={22} y={36} className="m m-card m-pdf"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/file-02.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=747f4b7c2718cb678673271f26a315a4" size={20} width="24" height="24" data-path="icons/hugeicons/file-02.svg" /><span className="m-pdf-tag">PDF</span></At>

    <Lines d={["M90 76 L 136 76"]} />

    <At x={142} y={30} w={100} className="m m-card m-chunk is-faded">
      <span className="m-skel" style={{ width: "70%" }} />
    </At>

    <At x={142} y={62} w={100} className="m m-card m-chunk is-on">
      <span className="m-skel" style={{ width: "84%" }} />
    </At>

    <At x={142} y={94} w={100} className="m m-card m-chunk is-faded">
      <span className="m-skel" style={{ width: "58%" }} />
    </At>
  </ArtTile>

  <ArtTile title="Qualitative analysis" href="https://supermemory.ai/research" art="/images/art/bg-meadow.jpg" pos="30% 60%" flip>
    <At x={42} y={10} w={180} className="m m-card m-board">
      <div className="m-board-head">LongMemEval</div>
      <div className="m-board-row is-on"><span className="m-ic is-on"><Icon icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/award-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=5bdc5b0838e753577e39a23b4274fcb3" size={12} width="24" height="24" data-path="icons/hugeicons/award-01.svg" /></span><span className="m-grow">Supermemory</span><span>1st</span></div>

      <div className="m-board-row is-faded">
        <span className="m-ic" />

        <span className="m-grow">
          <span className="m-skel" style={{ width: "64%" }} />
        </span>
      </div>

      <div className="m-board-row is-faded">
        <span className="m-ic" />

        <span className="m-grow">
          <span className="m-skel" style={{ width: "48%" }} />
        </span>
      </div>
    </At>
  </ArtTile>

  <ArtTile title="Plugins" href="/supermemory-mcp/mcp" art="/images/art/bg-lakeshore.jpg" pos="70% 40%" flip>
    <Tile x={20} y={52} size={48} src="/images/claude-code-icon.svg" logo on badge />

    <Tile x={82} y={52} size={48} src="/images/cursor-logo.svg" badge />

    <Tile x={144} y={52} size={48} src="/images/codex.svg" badge />

    <Tile x={206} y={52} size={48} src="/images/openclaw-logo.jpg" badge />
  </ArtTile>
</div>

With Supermemory, your agent remembers what each user has told it and uses that to answer more personally and more consistently.

Supermemory leads the LongMemEval and LoCoMo benchmarks and independent ones such as SWEContext. See the [benchmark results](https://supermemory.ai/research).

## How does it work? (at a glance)

<img src="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/RZUchfWXNk8FOiN_/images/how-it-works-overview.webp?fit=max&auto=format&n=RZUchfWXNk8FOiN_&q=85&s=54a2b9fe3ac7e982a35aa5907331e2ac" alt="Text, files, chats and connectors flow into Supermemory. The RAG path runs through the smart memory engine for search over documents; the user memory path builds a memory graph that tracks how facts change over time." width="2400" height="1350" data-path="images/how-it-works-overview.webp" />

* You send raw data in any format (text, files and chats), or connect a data source.
* Supermemory indexes it and builds a graph of what it learns about each entity: a user, a document, a project or an organization. Each entity is identified by a `containerTag`.
* Your agent searches that graph for memory or retrieval, and Supermemory keeps a profile of each entity up to date.

For the full pipeline, read [how ingestion works](/concepts/how-it-works).

## Why add memory to your agent?

Without memory, every session starts from zero. The model cannot know what the user preferred last week, which project they are on, or that a fact has changed since yesterday.

Memory gives an agent a lasting understanding of people and entities over time: their preferences, decisions, relationships and corrections. Retrieval (RAG) grounds answers in documents and knowledge bases. Most agents need both.

With memory, your agent can:

* Personalize answers with preferences, roles and history from earlier sessions, without putting the whole chat log in every prompt.
* Stay correct when facts change. If a user says "I love Adidas" and later "I'm switching to Puma", only the newer preference should hold.
* Pull the right policy, ticket or document when a question needs source material.
* Keep each customer's memory separate, so one user's data never leaks into another's.

Think of memory as the context a good teammate carries in their head, not a search box over raw logs. To see where retrieval ends and memory begins, read [Memory vs RAG](/concepts/memory-vs-rag).

## Why Supermemory?

* **It leads long-horizon memory benchmarks.** First on LongMemEval, LoCoMo and ConvoMem, and strong on independent benchmarks like SWEContext.
* **Memory is a graph.** Facts update, connect and expire in real time instead of sitting as nearest-neighbor chunks.
* **User profiles are built in.** Static and dynamic facts about each user are ready to drop into the prompt.
* **Memory and RAG share one engine.** Personalization and document search run on the same `containerTag`.
* **Every entry point uses one store.** The API, MCP, plugins, SMFS and connectors all read and write the same memories.
* **It is multimodal by default.** Text, chats, PDFs, images, video and code are extracted automatically, whether you upload them or sync them.
* **It runs where you need it.** Use the managed cloud, or self-host a single binary that also works offline.

<img src="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/RZUchfWXNk8FOiN_/images/readme-memory-graph.png?fit=max&auto=format&n=RZUchfWXNk8FOiN_&q=85&s=c270f8a713f281eae37c8bca3cb443ba" alt="memory graph" width="2828" height="1874" data-path="images/readme-memory-graph.png" />

<Note>
  Memory, profiles and SuperRAG share one context pool when they use the same `containerTag`. A container can be any scope you choose: a user, a project, a team or an organization.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/play.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=fbac7fd9d974ea65e013c203efb289a2" href="/quickstart" width="24" height="24" data-path="icons/hugeicons/play.svg">
    Make your first API call in minutes
  </Card>

  <Card title="How it works" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/cpu.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=b669601f6ec83ecf1a69938702040556" href="/concepts/how-it-works" width="24" height="24" data-path="icons/hugeicons/cpu.svg">
    Understand the knowledge graph architecture
  </Card>

  <Card title="Comparison" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/balance-scale.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=41d6eec40b7dd88ae9d7bbceb21f92de" href="/overview/comparison" width="24" height="24" data-path="icons/hugeicons/balance-scale.svg">
    vs DIY vectors, thin memory layers, pure RAG
  </Card>

  <Card title="Self-host it" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/server-stack-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=590817096f5123869559522e1b5c728d" href="/self-hosting/overview" width="24" height="24" data-path="icons/hugeicons/server-stack-01.svg">
    One binary, zero config, fully offline
  </Card>

  <Card title="Billing & plans" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/credit-card.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=2c74202cccfb4c9d11a9720079ea42dc" href="/overview/billing" width="24" height="24" data-path="icons/hugeicons/credit-card.svg">
    Credits, SM tokens, and how usage works
  </Card>

  <Card title="Security & compliance" icon="https://mintcdn.com/supermemory-capy-add-llmstxt-summary-and/LIMkcglt81IfjBVR/icons/hugeicons/shield-01.svg?fit=max&auto=format&n=LIMkcglt81IfjBVR&q=85&s=947ffb1744d6f6122d5aeeebaf5a7124" href="/overview/security" width="24" height="24" data-path="icons/hugeicons/shield-01.svg">
    SOC 2, GDPR, HIPAA BAA, encryption
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.