diff --git a/website/app/page.tsx b/website/app/page.tsx index a321d6d667..16a0ab89a8 100644 --- a/website/app/page.tsx +++ b/website/app/page.tsx @@ -8,6 +8,8 @@ import { ContextFunnel } from "@/components/site/ContextFunnel"; import { InfraTiles } from "@/components/site/InfraTiles"; import { MemoryScroll } from "@/components/site/MemoryScroll"; import { Benchmarks } from "@/components/site/Benchmarks"; +import { Runtime } from "@/components/site/Runtime"; +import { Scale } from "@/components/site/Scale"; import { Agents } from "@/components/site/Agents"; import { LocalFirst } from "@/components/site/LocalFirst"; import { Interfaces } from "@/components/site/Interfaces"; @@ -27,11 +29,13 @@ export default function Page() { + + diff --git a/website/components/site/Runtime.module.css b/website/components/site/Runtime.module.css new file mode 100644 index 0000000000..340152f8d0 --- /dev/null +++ b/website/components/site/Runtime.module.css @@ -0,0 +1,209 @@ +.figure { + display: grid; + grid-template-columns: minmax(0, 1.6fr) minmax(0, 1fr); + gap: var(--s-5); + align-items: stretch; +} + +.term { + border: 1px solid var(--ink); + border-radius: var(--radius-lg); + background: #0b0b0b; + color: #f2f2f2; + overflow: hidden; + box-shadow: var(--shadow); + min-width: 0; +} + +.termHead { + display: flex; + align-items: center; + gap: var(--s-3); + padding: var(--s-3) var(--s-4); + border-bottom: 1px solid rgba(255, 255, 255, 0.12); + font-size: var(--t-12); + color: rgba(250, 250, 250, 0.6); +} + +.lights { + display: inline-flex; + gap: 6px; +} + +.lights span { + width: 9px; + height: 9px; + border-radius: 50%; + background: rgba(250, 250, 250, 0.22); +} + +.lines { + list-style: none; + margin: 0; + padding: var(--s-4); + display: grid; + gap: var(--s-4); +} + +.line { + display: grid; + gap: 4px; + min-width: 0; +} + +:global(.js) .line { + opacity: 0; + transform: translateY(6px); +} + +:global(.is-in) .line { + opacity: 1; + transform: none; + transition: opacity 500ms var(--ease-out), transform 500ms var(--ease-out); + transition-delay: calc(var(--i) * 140ms); +} + +.cmd { + font-size: var(--t-14); + color: #f2f2f2; + overflow-wrap: anywhere; + background: none; + padding: 0; +} + +.dollar { + color: var(--accent); + margin-right: 0.6em; + user-select: none; +} + +.out { + font-size: var(--t-12); + color: rgba(250, 250, 250, 0.62); + padding-left: 1.4em; + line-height: 1.5; +} + +.stack { + border: 1px solid var(--line-2); + border-radius: var(--radius-lg); + background: var(--surface); + padding: var(--s-5); + display: flex; + flex-direction: column; + gap: var(--s-4); + min-width: 0; +} + +.stackHead { + font-size: var(--t-12); + color: var(--muted); + letter-spacing: var(--track-mono); + text-transform: uppercase; +} + +.layers { + list-style: none; + margin: 0; + padding: 0; + display: grid; + gap: var(--s-2); +} + +.layer { + display: grid; + grid-template-columns: minmax(0, 1fr) auto; + gap: 2px var(--s-3); + padding: var(--s-3); + border: 1px solid var(--line); + border-left: 3px solid var(--ink); + border-radius: var(--radius); + background: var(--bg); +} + +:global(.js) .layer { + opacity: 0; + transform: translateX(8px); +} + +:global(.is-in) .layer { + opacity: 1; + transform: none; + transition: opacity 500ms var(--ease-out), transform 500ms var(--ease-out); + transition-delay: calc(500ms + var(--i) * 120ms); +} + +.layer:first-child { + border-left-color: var(--accent); +} + +.layerName { + font-weight: 600; + font-size: var(--t-14); +} + +.layerSub { + font-size: var(--t-12); + color: var(--ink); + text-align: right; +} + +.layerNote { + grid-column: 1 / -1; + font-size: var(--t-12); + color: var(--muted); +} + +.stackFoot { + margin: auto 0 0; + font-size: var(--t-12); + color: var(--muted); + line-height: 1.5; +} + +.nowrap { + white-space: nowrap; +} + +.facts { + list-style: none; + margin: var(--s-6) 0 0; + padding: 0; + display: grid; + grid-template-columns: repeat(3, minmax(0, 1fr)); + gap: var(--s-5); +} + +.facts li { + display: grid; + gap: var(--s-2); + color: var(--ink-2); + font-size: var(--t-14); + line-height: var(--lh-body); +} + +.facts li > .mono, +.facts li > span:first-child { + font-size: var(--t-12); + color: var(--muted); + letter-spacing: var(--track-mono); + text-transform: uppercase; +} + +@media (max-width: 900px) { + .figure { + grid-template-columns: minmax(0, 1fr); + } + + .facts { + grid-template-columns: minmax(0, 1fr); + } +} + +@media (prefers-reduced-motion: reduce) { + :global(.js) .line, + :global(.js) .layer { + opacity: 1; + transform: none; + } +} diff --git a/website/components/site/Runtime.tsx b/website/components/site/Runtime.tsx new file mode 100644 index 0000000000..eea6a29801 --- /dev/null +++ b/website/components/site/Runtime.tsx @@ -0,0 +1,115 @@ +import { INSTALL_CMD } from "@/lib/site"; +import { Reveal } from "./client"; +import s from "./Runtime.module.css"; + +const SESSION = [ + { cmd: INSTALL_CMD, out: "installs the pinned iii engine on macOS, Linux or Windows, then starts Worker Compose" }, + { cmd: "agentmemory connect claude-code", out: "wires MCP and capture hooks into the agent you pick" }, + { cmd: "agentmemory demo --serve", out: "seeds sample sessions, shows recall, then stops the server it started" }, + { cmd: "agentmemory doctor", out: "finds config problems and offers a fix for each one" }, + { cmd: "agentmemory status", out: "health, memory count, feature flags and anything that needs attention" }, +]; + +const STACK = [ + { name: "iii engine", sub: "127.0.0.1:49134", note: "pinned version, checksum verified" }, + { name: "state worker", sub: "file state", note: "your data directory" }, + { name: "http worker", sub: "REST :3111", note: "bearer secret made on first start" }, + { name: "agentmemory worker", sub: "capture, search, graph", note: "viewer on :3113" }, +]; + +const FACTS = [ + { + key: "keys", + text: "None needed. Capture, keyword and graph search run on your machine. LLM features and cloud embeddings start only when you name a provider.", + }, + { + key: "service", + text: "Keep it running after logout with the systemd and launchd recipes, or one Docker Compose file.", + href: "/docs/deployment", + link: "deployment guide", + }, + { + key: "undo", + text: "agentmemory remove shows a plan, unwires every agent it connected and keeps your memory data unless you say otherwise.", + }, +]; + +export function Runtime() { + return ( +
+
+
+ Developer experience +

One command runs the whole memory stack.

+

+ No database to provision, no account, no Docker required. The CLI installs the runtime it needs, starts it on + loopback, wires your agents and tells you in plain words when something is off. +

+
+ + +
+
+
+
    + {SESSION.map((l, i) => ( +
  1. + + + {l.cmd} + + {l.out} +
  2. + ))} +
+
+ +
+
+ started by that first command +
+
    + {STACK.map((w, i) => ( +
  1. + {w.name} + {w.sub} + {w.note} +
  2. + ))} +
+

+ one Worker Compose project per instance; --instance 1 runs a second one beside it +

+
+
+ +
    + {FACTS.map((f) => ( +
  • + {f.key} + + {f.text} + {f.href ? ( + <> + {" "} + + {f.link} + + + ) : null} + +
  • + ))} +
+
+
+ ); +} diff --git a/website/components/site/Scale.module.css b/website/components/site/Scale.module.css new file mode 100644 index 0000000000..b6a2ef5ac4 --- /dev/null +++ b/website/components/site/Scale.module.css @@ -0,0 +1,193 @@ +.figure { + border: 1px solid var(--ink); + border-radius: var(--radius-lg); + background: var(--surface); + padding: var(--s-5); + display: grid; + gap: var(--s-4); + box-shadow: var(--shadow); +} + +.figHead { + display: flex; + justify-content: space-between; + align-items: baseline; + gap: var(--s-3); + font-size: var(--t-12); + color: var(--muted); + letter-spacing: var(--track-mono); + text-transform: uppercase; +} + +.figHead .src { + text-transform: none; + letter-spacing: 0; +} + +.lane { + display: grid; + grid-template-columns: 9rem minmax(0, 1fr); + gap: var(--s-4); + align-items: center; +} + +.laneLabel { + font-size: var(--t-12); + color: var(--muted); +} + +.after .laneLabel { + color: var(--ink); + font-weight: 600; +} + +.steps { + list-style: none; + margin: 0; + padding: 0; + display: grid; + grid-template-columns: repeat(3, minmax(0, 1fr)); + gap: var(--s-5); + position: relative; +} + +.step { + position: relative; + display: grid; + gap: 4px; + padding: var(--s-3); + border: 1px solid var(--line-2); + border-radius: var(--radius); + background: var(--bg); + min-width: 0; +} + +.step + .step::before { + content: ""; + position: absolute; + top: 50%; + left: calc(-1 * var(--s-5)); + width: var(--s-5); + height: 1px; + background: var(--line-2); +} + +.after .step { + border-color: var(--ink); +} + +.after .step + .step::before { + background: var(--ink); +} + +:global(.js) .step { + opacity: 0; + transform: translateY(6px); +} + +:global(.is-in) .step { + opacity: 1; + transform: none; + transition: opacity 500ms var(--ease-out), transform 500ms var(--ease-out); + transition-delay: calc(var(--i) * 140ms); +} + +:global(.is-in) .after .step { + transition-delay: calc(500ms + var(--i) * 140ms); +} + +.stepName { + font-size: var(--t-14); + background: none; + padding: 0; + overflow-wrap: anywhere; +} + +.stepNote { + font-size: var(--t-12); + color: var(--muted); + line-height: 1.45; +} + +.bad .stepName { + color: var(--muted); + text-decoration: line-through; + text-decoration-color: var(--faint); +} + +.good { + border-color: var(--accent) !important; + background: var(--accent-soft); +} + +.good .stepName { + color: var(--accent-ink); + font-weight: 600; +} + +.gains { + list-style: none; + margin: var(--s-6) 0 0; + padding: 0; + display: grid; + grid-template-columns: repeat(3, minmax(0, 1fr)); + gap: var(--s-5); +} + +.gain { + display: grid; + align-content: start; + gap: var(--s-2); + padding-top: var(--s-4); + border-top: 1px solid var(--line-2); +} + +.gain h3 { + margin: 0; + font-size: var(--t-16); + line-height: var(--lh-snug); +} + +.gain p { + margin: 0; + color: var(--ink-2); + font-size: var(--t-14); + line-height: var(--lh-body); +} + +.version { + font-size: var(--t-12); + color: var(--muted); +} + +@media (max-width: 900px) { + .gains { + grid-template-columns: minmax(0, 1fr); + } + + .lane { + grid-template-columns: minmax(0, 1fr); + gap: var(--s-2); + } +} + +@media (max-width: 640px) { + .steps { + grid-template-columns: minmax(0, 1fr); + gap: var(--s-3); + } + + .step + .step::before { + top: calc(-1 * var(--s-3)); + left: var(--s-4); + width: 1px; + height: var(--s-3); + } +} + +@media (prefers-reduced-motion: reduce) { + :global(.js) .step { + opacity: 1; + transform: none; + } +} diff --git a/website/components/site/Scale.tsx b/website/components/site/Scale.tsx new file mode 100644 index 0000000000..6e0cfce8bd --- /dev/null +++ b/website/components/site/Scale.tsx @@ -0,0 +1,123 @@ +import { REPO_URL } from "@/lib/site"; +import { Reveal } from "./client"; +import s from "./Scale.module.css"; + +const pr = (n: number) => `${REPO_URL}/pull/${n}`; + +const BEFORE = [ + { step: "state::list", note: "whole scope in one message" }, + { step: "16 MiB frame", note: "worker transport limit" }, + { step: "payload_too_large", note: "a big store looked empty", bad: true }, +]; + +const AFTER = [ + { step: "state::list_keys", note: "keys first, then records in pages" }, + { step: "64 MiB frame", note: "60 MiB payload guard below it" }, + { step: "every record", note: "scopes past 64 MiB keep working", good: true }, +]; + +const GAINS = [ + { + version: "0.9.33", + title: "Recall keeps every strong match", + text: "Saved memories are no longer capped at three per search, and keyword and vector search each pass at least 40 candidates into fusion.", + href: pr(1696), + ref: "#1696", + }, + { + version: "0.9.33", + title: "Long calls finish", + text: "The MCP shim no longer cuts proxied calls off at 15 s. It waits 190 s, past the 180 s server limit, so consolidate and reflect complete on large stores.", + href: pr(1691), + ref: "#1691", + }, + { + version: "0.9.33", + title: "Bounded reflection", + text: "Reflection reads lessons and crystals in pages and caps the evidence and insight it returns.", + href: pr(1544), + ref: "#1544", + }, + { + version: "0.9.33", + title: "Lean indexes", + text: "Evicted memories leave the keyword and vector indexes, and boot finds gaps in a partly embedded vector index.", + href: pr(1601), + ref: "#1601, #1687", + }, + { + version: "0.9.31", + title: "Incremental summaries", + text: "Summaries cover only what was captured since the last run. A session end with nothing new costs no LLM call.", + href: `${REPO_URL}/blob/main/CHANGELOG.md`, + ref: "changelog", + }, + { + version: "0.9.31", + title: "Graph never stalls a search", + text: "Graph enrichment gets 500 ms. When it runs out, keyword and vector results return without it.", + href: `${REPO_URL}/blob/main/docs/reliability/graph-search-budget.md`, + ref: "search budget", + }, +]; + +function Lane({ label, rows, tone }: { label: string; rows: { step: string; note: string; bad?: boolean; good?: boolean }[]; tone: "before" | "after" }) { + return ( +
+ {label} +
    + {rows.map((r, i) => ( +
  1. + {r.step} + {r.note} +
  2. + ))} +
+
+ ); +} + +export function Scale() { + return ( +
+
+
+ Performance +

Built to keep years of sessions searchable.

+

+ Your agent returns the top results, not the whole history. Under that, every read that could grow with your store + now pages, so a large memory stays fast to boot, search and export. +

+
+ + +
+ reading a large memory scope + + #1634, #1636 + +
+ + +
+ +
    + {GAINS.map((g, i) => ( + + v{g.version} +

    {g.title}

    +

    {g.text}

    + + {g.ref} + +
    + ))} +
+
+
+ ); +} diff --git a/website/lib/llms.ts b/website/lib/llms.ts index 865ed299cd..8fcf0c80ac 100644 --- a/website/lib/llms.ts +++ b/website/lib/llms.ts @@ -79,6 +79,15 @@ export function llmsFullTxt(): string { MCP_JSON, "```", "", + "## Operate", + "", + "- `agentmemory demo --serve` seeds sample sessions, shows recall and stops the server it started.", + "- `agentmemory doctor` finds configuration problems and offers a fix for each one.", + "- `agentmemory status` reports health, memory count and feature flags.", + "- `agentmemory stop` stops the runtime; `agentmemory remove` undoes agent connections and keeps memory data by default.", + "- No API key is needed. LLM features and cloud embeddings run only when `AGENTMEMORY_LLM_PROVIDER` or `EMBEDDING_PROVIDER` names a provider.", + `- Run it as a background service with the systemd and launchd recipes in ${SITE_URL}/docs/deployment.`, + "", "## How it works", "", "1. Capture. Hooks fire on every prompt and tool call. Each event is posted to the local server on port 3111 with a restart-safe id, or spooled to disk if the server is down.", @@ -97,6 +106,13 @@ export function llmsFullTxt(): string { "", ...others.map(agentLine), "", + "## Performance", + "", + "- State reads page through keys, and the worker transport limit is 64 MiB, so memory scopes larger than 64 MiB keep loading (0.9.33).", + "- Saved memories are no longer capped at three per search; keyword and vector search each pass at least 40 candidates into fusion (0.9.33).", + "- The MCP shim waits 190 s for proxied calls, past the 180 s server limit, so long consolidate and reflect calls finish (0.9.33).", + "- Summaries are incremental, and graph enrichment has a 500 ms budget before keyword and vector results return without it (0.9.31).", + "", "## Benchmarks", "", summary.longmemeval, diff --git a/website/lib/site.ts b/website/lib/site.ts index 93ee0c6722..4c95874662 100644 --- a/website/lib/site.ts +++ b/website/lib/site.ts @@ -213,7 +213,7 @@ export const FAQ = [ }, { q: "Do I need an API key?", - a: "No. Keyless mode works out of the box with BM25 recall. Set EMBEDDING_PROVIDER=local for free on-device semantic recall, or add a provider key for LLM consolidation.", + a: "No. Keyless mode works out of the box with BM25 and graph recall. Set EMBEDDING_PROVIDER=local for free on-device semantic recall. For LLM consolidation, set AGENTMEMORY_LLM_PROVIDER and that provider's key; a key alone sends nothing out.", }, { q: "Which agents does it work with?",