Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: Deploy project page
on:
push:
branches: [main]
paths: ["site/**", ".github/workflows/pages.yml"]
paths: ["landing/**", ".github/workflows/pages.yml"]
workflow_dispatch:

permissions:
Expand All @@ -26,6 +26,6 @@ jobs:
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
with:
path: site
path: landing
- id: deployment
uses: actions/deploy-pages@v4
27 changes: 27 additions & 0 deletions landing/base.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
*, *::before, *::after { box-sizing: border-box; }
html, body { overflow-x: clip; }
html { scrollbar-color: var(--color-muted) var(--color-paper); scroll-padding-top: var(--space-3xl); }
body { margin: 0; background: var(--color-paper); color: var(--color-ink); font-family: var(--font-body); font-size: var(--text-md); line-height: 1.55; -webkit-font-smoothing: antialiased; caret-color: var(--color-accent); }
::selection { background: color-mix(in oklab, var(--color-accent) 22%, transparent); }
:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 2px; }
a { color: inherit; text-decoration-thickness: 1px; text-underline-offset: 0.16em; }
h1, h2, h3 { margin: 0; font-family: var(--font-display); font-weight: var(--display-weight, 700); font-synthesis: none; letter-spacing: var(--tracking-display); line-height: 1.05; overflow-wrap: break-word; min-width: 0; text-wrap: balance; }
h1 { max-width: 20ch; font-size: var(--text-display); } h2 { max-width: 30ch; font-size: var(--text-section); } h3 { max-width: 40ch; font-size: var(--text-title); line-height: 1.2; }
.lead { font-size: var(--text-lead); line-height: 1.45; max-width: 52ch; }
p { margin: 0; text-wrap: pretty; }
p:not([class]) { max-width: 65ch; }
img, video { max-width: 100%; height: auto; display: block; }
svg { display: block; }
[hidden] { display: none !important; }
button, input, select, textarea { font: inherit; }
.container { width: 100%; max-width: var(--container); margin-inline: auto; padding-inline: var(--gutter); box-sizing: border-box; }
.num, .figure, td.num { font-variant-numeric: tabular-nums; }
.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
[data-slot] { position: relative; overflow: hidden; background: linear-gradient(160deg, var(--color-paper-2, var(--color-paper)), var(--color-paper-3, var(--color-paper))); }
[data-slot] > img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; z-index: 1; }
[data-slot]:has(> img) > :not(img):not([data-keep]) { display: none !important; }
@media (max-width: 60rem) { :root { --gutter: 24px; --section-gap-s: 80px; --section-gap: 96px; --section-gap-l: 120px; } }
@media (max-width: 40rem) { :root { --gutter: 16px; --section-gap-s: 56px; --section-gap: 72px; --section-gap-l: 96px; --gap-columns: 16px; } }
@media (prefers-reduced-motion: reduce) { *:not(.keep-motion), *:not(.keep-motion)::before, *:not(.keep-motion)::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; } }
/* photographs: natural sat=-10 con=4 */
[data-slot] > img { filter: saturate(0.9) contrast(1.04); }
135 changes: 135 additions & 0 deletions landing/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,135 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>HippocampAI BrainVault, memory on a USB drive</title>
<meta name="description" content="BrainVault and an agentic chat pipeline built on Rex Divakar&#39;s HippocampAI memory engine: encrypted memory that lives on a USB drive. First runner-up at the SanDisk Hackathon, Vellore.">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wdth,wght@12..96,75..100,500..800&family=Source+Serif+4:ital,opsz,wght@0,8..60,400;1,8..60,400&display=swap" rel="stylesheet">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<a class="skip" href="#main">Skip to content</a>

<header class="mast">
<div class="container">
<a class="wordmark" href="#main">HippocampAI</a>
<nav aria-label="Page">
<ul>
<li><a href="#contents">What it does</a></li>
<li><a href="#vault">The vault</a></li>
<li><a href="#start">Install</a></li>
<li><a href="https://github.com/boss477/HippocampAI">GitHub</a></li>
</ul>
</nav>
</div>
</header>

<section class="hero" id="main">
<div class="container">
<h1>Memory that travels on a USB drive</h1>
<div class="hero__foot cols">
<p class="lead">BrainVault adds an encrypted, portable vault to the HippocampAI memory engine.</p>
<div class="actions">
<a class="btn" href="https://github.com/boss477/HippocampAI">Read the code</a>
<a class="btn btn--line" href="#start">Install with pip</a>
</div>
</div>
</div>
</section>

<main>
<section class="contents" id="contents">
<div class="container">
<h2 class="heavy">What the team added, and what it builds on</h2>
<ul class="rows">
<li class="cols"><h3>BrainVault</h3><p>Writes every memory to a USB drive as encrypted files, and restores them.</p><small>export_to_usb.py</small></li>
<li class="cols"><h3>Agentic chat</h3><p>Redis holds the last 20 turns. The agent decides which statements to keep.</p><small>brain_flow</small></li>
<li class="cols"><h3>Recall</h3><p>Hybrid search across vectors and BM25, reranked by a cross-encoder.</p><small>the HippocampAI engine</small></li>
</ul>
</div>
</section>

<section class="band">
<div class="container">
<h2>Runner-up at the SanDisk Hackathon</h2>
<dl class="stats">
<div><dt>teams entered, across four VIT campuses</dt><dd>1,000+</dd></div>
<div><dt>shortlist the team reached</dt><dd>Top 50</dd></div>
<div><dt>final placing, as first runner-up</dt><dd>2nd</dd></div>
<div><dt>prize, in rupees</dt><dd>50,000</dd></div>
</dl>
</div>
</section>

<section class="paper">
<div class="container">
<blockquote class="heavy">
<p>Built from one survey of implicit, explicit and agentic memory in language models.</p>
<footer><a class="link" href="https://arxiv.org/abs/2601.09113">The AI Hippocampus: How Far are We From Human Memory?</a> Jia et al., 2026.</footer>
</blockquote>
</div>
</section>

<section class="trip" id="vault">
<div class="container cols">
<h2>Out to the drive, and back</h2>
<section aria-labelledby="t-out">
<h3 id="t-out">Export</h3>
<ol>
<li>The API hands over every memory.</li>
<li>Fernet encrypts them from your password.</li>
<li>Timestamped files land on the drive.</li>
</ol>
</section>
<section aria-labelledby="t-in">
<h3 id="t-in">Restore</h3>
<ol>
<li>The latest export is found.</li>
<li>It is decrypted to JSON.</li>
<li>Any running instance ingests it.</li>
</ol>
</section>
</div>
</section>

<section class="start" id="start">
<div class="container cols">
<div class="start__text">
<h2 class="heavy">Store and recall in ten lines</h2>
<p class="lead">Install the package, then remember and recall.</p>
<a class="btn btn--line" href="https://github.com/boss477/HippocampAI#quick-start">Open the quick start</a>
</div>
<figure>
<pre tabindex="0" aria-label="Install and first memory"><code>pip install "hippocampai[saas]"

from hippocampai import MemoryClient

client = MemoryClient()
client.remember(
"I prefer working remotely on Tuesdays",
user_id="alice",
type="preference",
)
results = client.recall("work preferences", user_id="alice")
print(results[0].memory.text)</code></pre>
<figcaption>From the repository README.</figcaption>
</figure>
</div>
</section>
</main>

<footer class="foot">
<div class="container cols heavy">
<p>BrainVault, the agentic chat pipeline and the USB tools were built for the SanDisk Hackathon in Vellore, on the open-source <a class="link" href="https://github.com/rexdivakar/HippocampAI">HippocampAI engine by Rex Divakar</a> (Apache 2.0).</p>
<ul>
<li><a class="link" href="https://github.com/boss477/HippocampAI">Repository</a></li>
<li><a class="link" href="https://github.com/boss477/HippocampAI/tree/main/docs">Documentation</a></li>
<li><a class="link" href="https://github.com/boss477/HippocampAI/blob/main/LICENSE">Licence</a></li>
</ul>
</div>
</footer>
</body>
</html>
97 changes: 97 additions & 0 deletions landing/styles.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
/* Hallmark · shape: Long Document · genre: editorial · theme: Editorial (by request) · job: sign up · draw: manual
* hero: Banner · nav: masthead · footer: colophon block · imagery: none, type and the hackathon's own figures · signature: the cover line set across the full measure under a masthead, like the front of a magazine
* axes: light/condensed-grotesk/green · posture: restrained · contrast: pass · fold: pass · v2.0.0 */
/* Hallmark · pre-emit critique: P4 H5 E4 S4 R5 V5 · weakest: S, a memory engine reads like many others; led with the USB vault, the one thing only this build has */
@import url("./tokens.css");
@import url("./base.css");

body { font-size: 1.125rem; line-height: 1.55; color: var(--color-ink-2); font-variant-numeric: oldstyle-nums; }
h1, h2, h3 { font-variation-settings: "wdth" 75, "opsz" 96; color: var(--color-ink); font-variant-numeric: lining-nums tabular-nums; line-height: 1; }
small, figcaption, nav, .btn, .label { font-family: var(--font-display); font-weight: 500; font-variation-settings: "opsz" 12; }
.cols { display: grid; grid-template-columns: repeat(12, minmax(0, 1fr)); column-gap: var(--gap-columns); }
.lead { color: var(--color-ink); line-height: 1.3; }
.heavy { border-top: var(--rule-heavy) solid var(--color-ink); padding-top: var(--space-lg); }

.btn { display: inline-flex; align-items: center; min-height: 48px; padding: 0 var(--space-lg); border: var(--rule-hair) solid var(--color-ink); border-radius: 0; background: var(--color-ink); color: var(--color-paper); font-size: var(--text-md); line-height: 1; white-space: nowrap; text-decoration: none; cursor: pointer; transition: background-color var(--dur-short) var(--ease-out); }
.btn:hover { background: var(--color-ink-2); }
.btn:active { background: var(--color-muted); }
.btn--line { background: transparent; color: var(--color-ink); }
.btn--line:hover { background: var(--color-paper-2); }
.btn--line:active { background: var(--color-paper-3); }
.btn:disabled { opacity: 0.55; cursor: not-allowed; }
.link { text-decoration: underline var(--rule-hair) var(--color-rule-2); text-underline-offset: 0.24em; transition: text-decoration-color var(--dur-short) var(--ease-out); }
.link:hover { text-decoration-color: var(--color-accent); }

.mast { padding-top: var(--space-lg); text-align: center; }
.mast .wordmark { display: inline-block; font: var(--display-weight) clamp(2rem, 4.6vw, 4rem)/1 var(--font-display); font-variation-settings: "wdth" 75, "opsz" 96; letter-spacing: var(--tracking-display); color: var(--color-ink); text-decoration: none; }
.mast nav { margin-top: var(--space-md); border-block: var(--rule-hair) solid var(--color-rule-2); }
.mast ul { display: flex; justify-content: center; gap: var(--space-2xl); margin: 0; padding: 0; list-style: none; }
.mast li a { display: inline-flex; align-items: center; min-height: 44px; font-size: var(--text-sm); color: var(--color-ink); text-decoration: none; white-space: nowrap; }
.mast li a:hover { text-decoration: underline var(--rule-hair) var(--color-accent); text-underline-offset: 0.3em; }

.hero { padding-block: var(--space-2xl) var(--space-xl); }
.hero h1 { max-width: 13ch; font-size: clamp(3.25rem, 9.4vw, 9rem); line-height: 0.9; }
.hero__foot { align-items: end; margin-top: var(--space-xl); }
.hero .lead { grid-column: 1 / span 6; max-width: 34ch; }
.actions { grid-column: 8 / -1; display: flex; flex-wrap: wrap; justify-content: flex-end; gap: var(--space-md); }

.contents { padding-block: var(--section-gap-s) var(--section-gap); }
.contents h2 { margin-bottom: var(--space-xl); }
.rows { margin: 0; padding: 0; list-style: none; }
.rows li { align-items: baseline; padding-block: var(--space-lg); border-top: var(--rule-hair) solid var(--color-rule); }
.rows li:first-child { border-top: 0; }
.rows h3 { grid-column: 1 / span 4; font-size: clamp(1.75rem, 2.8vw, 2.5rem); }
.rows p { grid-column: 5 / span 5; max-width: none; }
.rows small { grid-column: 10 / -1; justify-self: end; font-size: var(--text-sm); color: var(--color-muted); text-align: end; }

.band { padding-block: var(--space-3xl); background: var(--color-ink); color: var(--color-paper); --color-focus: var(--color-paper); }
.band h2 { color: var(--color-paper); margin-bottom: var(--space-2xl); }
.stats { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); margin: 0; }
.stats > div { display: flex; flex-direction: column; padding-inline: var(--space-lg); border-left: var(--rule-hair) solid var(--color-muted); }
.stats > div:first-child { padding-left: 0; border-left: 0; }
.stats dd { margin: 0; font: var(--display-weight) var(--text-display)/1 var(--font-display); font-variation-settings: "wdth" 75, "opsz" 96; font-variant-numeric: lining-nums tabular-nums; white-space: nowrap; }
.stats dt { order: 2; margin-top: var(--space-sm); font: 500 var(--text-sm)/1.4 var(--font-display); font-variation-settings: "opsz" 12; }

.paper { padding-block: var(--section-gap) var(--section-gap-s); }
.paper blockquote { margin: 0; }
.paper blockquote p { max-width: 30ch; font-size: var(--text-display-s); line-height: 1.15; color: var(--color-ink); }
.paper footer { margin-top: var(--space-lg); font-family: var(--font-display); font-weight: 500; font-variation-settings: "opsz" 12; font-size: var(--text-sm); color: var(--color-muted); }

.trip { padding-block: var(--space-3xl); background: var(--color-paper-2); border-top: var(--rule-hair) solid var(--color-rule-2); }
.trip h2 { grid-column: 1 / -1; margin-bottom: var(--space-2xl); }
.trip section { grid-column: span 6; }
.trip h3 { margin-bottom: var(--space-md); }
.trip ol { margin: 0; padding: 0; list-style: none; counter-reset: s; }
.trip li { counter-increment: s; display: grid; grid-template-columns: 2ch minmax(0, 1fr); gap: var(--space-lg); padding-block: var(--space-md); border-top: var(--rule-hair) solid var(--color-rule); }
.trip li::before { content: counter(s); font: var(--display-weight) var(--text-title)/1.2 var(--font-display); font-variation-settings: "wdth" 75, "opsz" 96; color: var(--color-ink); }

.start { padding-block: var(--section-gap-s) var(--section-gap); }
.start__text { grid-column: 1 / span 5; }
.start__text .lead { margin-top: var(--space-lg); }
.start__text .btn { margin-top: var(--space-xl); }
.start figure { grid-column: 6 / -1; margin: 0; min-width: 0; }
.start pre { margin: 0; padding: var(--space-xl); overflow-x: auto; background: var(--color-paper-2); border-top: var(--rule-hair) solid var(--color-rule-2); font: 400 var(--text-sm)/1.8 var(--font-mono); color: var(--color-ink); }
.start code { font-family: var(--font-mono); }
.start figcaption { margin-top: var(--space-sm); font-size: var(--text-sm); color: var(--color-muted); }

.foot { padding-block: var(--space-2xl) var(--space-3xl); }
.foot p { grid-column: 1 / span 7; max-width: 60ch; font-size: var(--text-md); }
.foot ul { grid-column: 9 / -1; display: grid; gap: var(--space-xs); margin: 0; padding: 0; list-style: none; font-family: var(--font-display); font-weight: 500; font-size: var(--text-sm); }
.foot li a { display: inline-flex; align-items: center; min-height: 44px; white-space: nowrap; }

.skip { position: absolute; left: var(--space-md); top: calc(-1 * var(--space-4xl)); z-index: var(--z-toast); padding: var(--space-xs) var(--space-md); background: var(--color-ink); color: var(--color-paper); }
.skip:focus-visible { top: var(--space-md); }

@media (max-width: 60rem) {
.mast ul { gap: var(--space-lg); }
.mast li:nth-child(2) { display: none; }
.hero .lead, .actions, .rows h3, .rows p, .rows small, .trip section, .start__text, .start figure, .foot p, .foot ul { grid-column: 1 / -1; }
.actions { justify-content: flex-start; margin-top: var(--space-lg); }
.rows li { row-gap: var(--space-xs); }
.rows small { justify-self: start; text-align: start; }
.stats { grid-template-columns: repeat(2, minmax(0, 1fr)); row-gap: var(--space-xl); }
.stats > div:nth-child(odd) { padding-left: 0; border-left: 0; }
.trip section + section, .start figure, .foot ul { margin-top: var(--space-xl); }
.start pre { padding: var(--space-lg); }
}
@media (prefers-reduced-motion: reduce) { .btn, .link { transition: none; } }
19 changes: 19 additions & 0 deletions landing/tokens.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
:root {
color-scheme: light;
--space-3xs: 2px; --space-2xs: 4px; --space-xs: 8px; --space-sm: 12px; --space-md: 16px; --space-lg: 24px; --space-xl: 40px; --space-2xl: 64px; --space-3xl: 96px; --space-4xl: 144px;
--text-xs: 0.8125rem; --text-sm: 0.875rem; --text-md: 1rem; --text-lg: 1.25rem; --text-xl: 1.5625rem; --text-2xl: 1.953rem; --text-3xl: 2.441rem;
--text-display-s: clamp(2.25rem, 4vw + 0.5rem, 3.75rem); --text-display: clamp(2.75rem, 5vw + 1rem, 5.25rem);
--text-section: clamp(2rem, 2.5vw + 1rem, 3.5rem); --text-title: clamp(1.25rem, 0.75vw + 0.875rem, 1.625rem); --text-lead: clamp(1.125rem, 0.35vw + 1rem, 1.375rem);
--ease-out: cubic-bezier(0.16, 1, 0.3, 1); --ease-in: cubic-bezier(0.7, 0, 0.84, 0); --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
--dur-micro: 120ms; --dur-short: 220ms; --dur-long: 420ms;
--color-error: oklch(52% 0.19 27); --color-success: oklch(50% 0.12 150);
--container: 1440px; --gutter: 64px; --gap-columns: 32px; --section-gap-s: 120px; --section-gap: 144px; --section-gap-l: 176px;
--z-base: 1; --z-raised: 10; --z-dropdown: 100; --z-sticky: 200; --z-sticky-nav: 300; --z-modal: 400; --z-toast: 500; --z-tooltip: 600;
--color-paper: oklch(97% 0.007 86); --color-paper-2: oklch(94% 0.010 86); --color-paper-3: oklch(91% 0.012 84);
--color-ink: oklch(16% 0.012 280); --color-ink-2: oklch(29% 0.011 280); --color-muted: oklch(48% 0.010 75);
--color-rule: oklch(85% 0.009 85); --color-rule-2: oklch(64% 0.010 80);
--color-accent: oklch(49% 0.130 152); --color-accent-ink: oklch(98% 0.005 88); --color-focus: oklch(52% 0.135 152);
--font-display: "Bricolage Grotesque", ui-sans-serif, sans-serif; --font-body: "Source Serif 4", ui-serif, Georgia, serif;
--font-mono: ui-monospace, "Cascadia Mono", Consolas, monospace; --radius-card: 0; --radius-pill: 0; --rule-hair: 1px; --rule-heavy: 4px; --shadow-card: none;
--tracking-display: -0.012em; --display-weight: 800;
}
Loading