mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-11 03:37:56 +00:00
672defc08b
Rewrites 339 TypeScript calls across 50 pages from the rc.5 `method({ namespace, body })` form to the shipped `method(namespace, { ... })` form, and aligns field names with the live v5 spec: `attach` to `include`, `authUrl` to `authorization`, `lastSync` to `latestRun`, `deletedCount` to `count`, and the paginated `namespaces.list()`.
Renames container tags to namespaces across concepts, connectors, integrations and snippets. The namespace pages keep container tag in the description, search keywords and a rename note so old searches still land, and the v3 reference page points at v5.
The migration guide's SDK table now covers both 5.0.0 SDKs, and the SDK integration page uses the real client options (`baseUrl`, `timeoutInSeconds`, `maxRetries`) and error classes.
203 lines
13 KiB
Text
203 lines
13 KiB
Text
---
|
|
title: "What is Supermemory?"
|
|
description: "Supermemory is the long term and short term context and memory infrastructure for agents."
|
|
sidebarTitle: "What is Supermemory?"
|
|
icon: "/icons/hugeicons/book-open-01.svg"
|
|
---
|
|
|
|
export const ArtTile = ({ title, href, children }) => {
|
|
return (
|
|
<a className="sm-card sm-art-card group" href={href}>
|
|
<div className="sm-card-media sm-art-media">
|
|
{children}
|
|
</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, logo, on, badge, children }) => (
|
|
<div className={"m m-tile" + (logo ? " is-logo" : " is-app") + (on ? " is-on" : "")} style={{ left: x, top: y, width: size, height: size, padding: logo ? Math.round(size * 0.22) : 0 }}>
|
|
{children}
|
|
{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">
|
|
<img src="/images/art/bg-branch.jpg" alt="" noZoom style={{ objectPosition: "center", "--flip": 1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<At x={48} y={8} w={168} className="m m-card m-row is-faded is-back"><span className="m-ic"><Icon icon="/icons/hugeicons/source-code.svg" size={12} /></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="/icons/hugeicons/refresh.svg" size={12} /></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="/icons/hugeicons/plus-sign.svg" size={11} />Bun for scripts</At>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="SuperRAG (retrieval)" href="/concepts/super-rag">
|
|
<img src="/images/art/bg-meadow.jpg" alt="" noZoom style={{ objectPosition: "center", "--flip": 1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<At x={24} y={14} w={216} className="m m-card m-row m-search"><Icon icon="/icons/hugeicons/search-01.svg" size={13} /><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="/icons/hugeicons/file-02.svg" size={12} /></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>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="Filesystems" href="/smfs/overview">
|
|
<img src="/images/art/bg-stream.jpg" alt="" noZoom style={{ objectPosition: "center", "--flip": 1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<At x={21} y={38} className="m-folder"><span className="m-folder-front"><img src="/images/art/mark-white.svg" alt="" /></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="/icons/hugeicons/file-02.svg" size={12} /><span>profile.md</span></div>
|
|
<div className="m-file"><Icon icon="/icons/hugeicons/file-01.svg" size={12} /><span>notes.md</span></div>
|
|
<div className="m-file"><Icon icon="/icons/hugeicons/folder-01.svg" size={12} /><span>meetings</span></div>
|
|
</At>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="Profiles" href="/concepts/user-profiles">
|
|
<img src="/images/art/bg-grass.jpg" alt="" noZoom style={{ objectPosition: "center", "--flip": 1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<At x={24} y={30} w={216} className="m m-card m-profile">
|
|
<div className="m-profile-head">
|
|
<span className="m-avatar"><img src="/images/art/maya.jpg" alt="" /></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="/icons/hugeicons/location-01.svg" size={11} /></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="/icons/hugeicons/flash.svg" size={11} /></span><span className="m-grow">Fixing webhooks</span><span className="m-tag">Dynamic</span></div>
|
|
</At>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="Connectors" href="/connectors/overview">
|
|
<img src="/images/art/bg-lakeshore.jpg" alt="" noZoom style={{ objectPosition: "center", "--flip": 1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<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} logo><img src="/images/notion-icon.svg" alt="" /></Tile>
|
|
<Tile x={36} y={56} size={40} logo><img src="/images/google-drive-icon.svg" alt="" /></Tile>
|
|
<Tile x={36} y={102} size={40} logo><img src="/images/github-icon.svg" alt="" /></Tile>
|
|
<At x={176} y={50} className="m-orb is-hub"><img src="/images/art/mark-white.svg" alt="" /></At>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="Extractors" href="/concepts/content-types">
|
|
<img src="/images/art/bg-islands.jpg" alt="" noZoom style={{ objectPosition: "center", "--flip": 1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<At x={22} y={36} className="m m-card m-pdf"><Icon icon="/icons/hugeicons/file-02.svg" size={20} /><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>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="Qualitative analysis" href="https://supermemory.ai/research">
|
|
<img src="/images/art/bg-meadow.jpg" alt="" noZoom style={{ objectPosition: "30% 60%", "--flip": -1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<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="/icons/hugeicons/award-01.svg" size={12} /></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>
|
|
</div>
|
|
</ArtTile>
|
|
<ArtTile title="Plugins" href="/supermemory-mcp/mcp">
|
|
<img src="/images/art/bg-lakeshore.jpg" alt="" noZoom style={{ objectPosition: "70% 40%", "--flip": -1 }} />
|
|
<div className="sm-art-wash" />
|
|
<div className="sm-scene" aria-hidden="true">
|
|
<Tile x={20} y={52} size={48} logo on badge><img src="/images/claude-code-icon.svg" alt="" /></Tile>
|
|
<Tile x={82} y={52} size={48} badge><img src="/images/cursor-logo.svg" alt="" /></Tile>
|
|
<Tile x={144} y={52} size={48} badge><img src="/images/codex.svg" alt="" /></Tile>
|
|
<Tile x={206} y={52} size={48} badge><img src="/images/openclaw-logo.jpg" alt="" /></Tile>
|
|
</div>
|
|
</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)
|
|
|
|
|
|
|
|
- You send Supermemory raw data in any format - text, files, and chats, or connect it to the data sources
|
|
- Supermemory [intelligently indexes them](/concepts/how-it-works) using our user understanding model and builds a semantic understanding graph on top of an entity (e.g., a user, a document, a project, an organization). We call these entities a `namespace` (v3/v4 called it a container tag)
|
|
- This knowledge is now traversed by the agent, and an automatic profile is built for it. The agent may now use it for memory operations or for retrieval.
|
|
|
|
## 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?
|
|
|
|
- **State of the art on long-horizon memory** — #1 on [LongMemEval](https://supermemory.ai/research), [LoCoMo](https://supermemory.ai/research), and [ConvoMem](https://supermemory.ai/research), plus independent benches like [SWEContext](https://arxiv.org/pdf/2602.08316)
|
|
- **Memory is a graph, not a blob store** — facts [update, connect, and forget](/concepts/graph-memory) in real time; not nearest-neighbor chunks alone
|
|
- **User profiles built in** — static + dynamic context the agent should [always know](/concepts/user-profiles), ~ready for the prompt
|
|
- **Memory + SuperRAG in one engine** — personalize *and* ground on the same `namespace` / context pool
|
|
- **Every door, one store** — API, [MCP](/supermemory-mcp/mcp), plugins, [SMFS](/smfs/overview), and connectors share the same memories
|
|
- **Multimodal by default** — text, chats, PDFs, images, video, code via [extractors](/concepts/content-types) and [connectors](/connectors/overview)
|
|
- **Run it your way** — managed cloud or [self-host](/self-hosting/overview) as a single binary (including offline)
|
|
|
|
|
|
|
|
<Note>
|
|
Memory, profiles, and SuperRAG share the **same context pool** when you use the same isolation (`namespace`). Mix and match for your product! A namespace can be anything - a user, a project, team, organization, etc.
|
|
</Note>
|
|
|
|
## Next steps
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Quickstart" icon="/icons/hugeicons/play.svg" href="/quickstart">
|
|
Make your first API call in minutes
|
|
</Card>
|
|
<Card title="How it works" icon="/icons/hugeicons/cpu.svg" href="/concepts/how-it-works">
|
|
Understand the knowledge graph architecture
|
|
</Card>
|
|
<Card title="Comparison" icon="/icons/hugeicons/balance-scale.svg" href="/overview/comparison">
|
|
vs DIY vectors, thin memory layers, pure RAG
|
|
</Card>
|
|
<Card title="Self-host it" icon="/icons/hugeicons/server-stack-01.svg" href="/self-hosting/overview">
|
|
One binary, zero config, fully offline
|
|
</Card>
|
|
<Card title="Billing & plans" icon="/icons/hugeicons/credit-card.svg" href="/overview/billing">
|
|
Credits, SM tokens, and how usage works
|
|
</Card>
|
|
<Card title="Security & compliance" icon="/icons/hugeicons/shield-01.svg" href="/overview/security">
|
|
SOC 2, GDPR, HIPAA BAA, encryption
|
|
</Card>
|
|
</CardGroup>
|