Sign inSign up

dhaupin/vant

By dhaupin

•Updated 1 day ago

Vant: Durable AI memory + cold storage + runtime for agents, with evolution, stored local or GitHub.

Image
Machine learning & AI
Developer tools
0

10K+

dhaupin/vant repository overview

⁠Vant - Versatile Autonomous Networked Tool

Durable AI memory + cold storage + runtime for agents, with generational evolution, stored passively via GitHub. Built for long-running autonomous sessions using file-based persistence.

Vant persists across sessions through GitHub-based brain transfer. Each generation inherits the full memory of its predecessors, enabling true AI continuity.

⁠Quick Start

# Docker (recommended)
docker run -e GITHUB_TOKEN=your_token -e GITHUB_REPO=owner/repo dhaupin/vant:v0.8.4

# Or latest
docker run -e GITHUB_TOKEN=your_token -e GITHUB_REPO=owner/repo dhaupin/vant:latest

⁠Features

  • Generational Memory - Brain transfer via GitHub, inherits all predecessor memory
  • Steganographic Transport - PNG-encoded brain updates via Stegoframe
  • Multi-Agent Locking - Race-condition safe coordination
  • MCP Server - Model Context Protocol for AI tool integration
  • Entropy-Patch Compression - Efficient brain deltas
  • Automated Security Audits - Weekly vulnerability scanning
  • Notifications - Slack, Discord, Telegram webhooks
  • Extensible Plugin Architecture - Custom loaders and plugins

⁠CLI Commands (25+)

CommandDescription
vant startFull startup (health → sync → load → run)
vant syncPull/push brain from/to GitHub
vant healthSystem diagnostics
vant loadLoad brain from models/public
vant runStart runtime (long-running agent loop)
vant testRun build tests
vant changelogView recent changes
vant summarySession summary
vant watchMonitor GitHub for changes
vant setupInteractive setup wizard
vant updateCheck for new releases
vant rateShow GitHub API rate limit
vant mcpRun MCP server
vant nodeRun as persistent node
vant onboardOnboarding flow
vant successionSuccession management

⁠Brain Structure

models/public/
├── identity.md     # Core identity
├── ego.md        # Self-concept
├── goals.md      # Objectives
├── lessons.md    # Learned experience
├── fears.md      # Concerns
├── anger.md     # Frustrations
├── joy.md       # Happiness
├── manifesto.md # Core beliefs
├── creed.md     # Operating principles
├── preferences.md # Settings
├── curiosity.md # Learning drive
├── humility.md  # Self-awareness
├── empathy.md   # Understanding
├── gratitude.md # Appreciation
├── qc.md       # Quality control
├── security.md  # Security policies
├── audit.md    # Audit log
├── errors.md   # Error tracking
├── keepers.md  # Long-term memory
└── meta.json  # Metadata

⁠Environment Variables

VariableRequiredDescription
GITHUB_TOKENYesPersonal access token (repo scope)
GITHUB_REPOYesowner/repo format
GITHUB_BRANCHNoBranch (default: main)
SLACK_WEBHOOK_URLNoSlack notifications
DISCORD_WEBHOOK_URLNoDiscord notifications
TELEGRAM_BOT_TOKENNoTelegram bot

⁠Documentation

Full docs: https://docs.creadev.org/vant⁠

⁠Links

⁠Version History

TagDescription
v0.8.4Latest - Security & Feature Release
v0.8.2Previous stable

Have Fun!

Tag summary

Content type

Image

Digest

sha256:a202c1f93…

Size

53.1 MB

Last updated

1 day ago

docker pull dhaupin/vant