Persistent AI memory via GitHub - each session inherits full context
v0.8.6 · Lander · Docs · GitHub
Vant is your persistent memory system for AI agents. Each session inherits everything previous agents wrote - your brain lives in GitHub as files you control.
Think of it as: your soul that reincarnates with full memories.
docker run -e GITHUB_TOKEN=ghp_xxx -e GITHUB_REPO=owner/repo dhaupin/vantThat's it.
git clone https://github.com/dhaupin/vant.git
cd vant
echo "GITHUB_TOKEN=ghp_xxx" > .env
echo "GITHUB_REPO=owner/repo" >> .env
npm start| Env | Required | Default |
|---|---|---|
GITHUB_TOKEN |
✓ | - |
GITHUB_REPO |
✓ | - |
GITHUB_BRANCH |
- | main |
MODEL_PATH |
- | models/private |
MCP_API_KEY |
- | - |
| Feature | What It Does |
|---|---|
| Brain | Files in GitHub - each session reads context |
| Memory | models/private/ - identity, goals, lessons... |
| Sync | Push/pull brain state via GitHub API |
| MCP Server | 21 tools for AI agents (optional) |
| Islands | Lazy-loadable integrations |
| Multi-Agent | Branch-per-agent workflow |
Optional Features: Webhooks, Notifications, Steganography
Use Vant as a library with REST API (no MCP required):
const vant = require('./lib/vant');
// Start headless server
const result = await vant.startHeadless({ port: 3000, debug: true });
// Returns: { started: true, mode: 'headless', endpoints: { health, tools, brain } }
// Or programmatic API (no server)
await vant.init({ taskId: 'my-task' });
await vant.learn('key', 'content');
const content = await vant.remember('key');| Variable | Description |
|---|---|
VANT_MODE |
Force mode: cli, mcp, or headless |
VANT_MCP_PORT |
MCP server port |
MCP_REQUIRE_KEY |
Require API key for MCP access |
Full docs at docs.creadev.org/vant
- Quick Start - 2 min setup
- Installation - All methods
- Setup - Configure
- The Brain - Your memory files
- Runtime - Programmatic API
- Islands - Lazy-load integrations
- Succession - Trust levels
- Multi-Agent - Team workflow
- GitHub - Brain storage
- MCP - 21 AI tools
- Agent Skills - Claude/Codex/Cursor
- Linear - Issue sync
- Docker - Container deploy
- CLI - All commands
- Configuration - Env options
- Lander: vant.creadev.org
- Docs: docs.creadev.org/vant
- GitHub: github.com/dhaupin/vant
- Issues: github.com/dhaupin/vant/issues