Skip to content

kejun/agent-memory-demos

Repository files navigation

AI Agent Memory System Demos

A comprehensive collection of 10 interactive demonstrations showcasing different memory system architectures for AI agents. Built with React, Vite, TypeScript, and TailwindCSS.

React TypeScript Vite TailwindCSS

๐ŸŽฏ Overview

This project demonstrates various memory system implementations that can be used in AI agents, from basic storage to advanced graph-based knowledge representations. Each demo is fully interactive and includes simulated backend logic.

๐Ÿ“š Demo Catalog

Demo Title Description
1 Basic Memory Storage Foundation of memory systems - storing and retrieving information with metadata
2 Semantic Search Find memories by meaning using vector embeddings and similarity search
3 Conversation Context Maintain context across multi-turn conversations
4 Memory Consolidation Combine related memories into stronger representations
5 Forgetting Curve Implement Ebbinghaus forgetting curve for natural memory decay
6 Working Memory Short-term memory with limited capacity and expiration
7 Episodic Memory Memory of specific events with contextual details (what, where, when, who)
8 Procedural Memory Memory for skills, procedures, and "how-to" knowledge
9 Memory Graph Knowledge graph representation with nodes and edges for associative reasoning
10 Meta Memory Memory about memory - monitoring and optimizing the memory system itself

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/kejun/agent-memory-demos.git
cd agent-memory-demos

# Install dependencies
npm install

# Start development server
npm run dev

The application will be available at http://localhost:3000

Build for Production

npm run build
npm run preview

๐Ÿ—๏ธ Project Structure

agent-memory-demos/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/          # Shared UI components
โ”‚   โ”‚   โ”œโ”€โ”€ ChatInterface.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ MemoryPanel.tsx
โ”‚   โ”‚   โ””โ”€โ”€ Visualization.tsx
โ”‚   โ”œโ”€โ”€ pages/               # Demo pages (Demo1-Demo10)
โ”‚   โ”œโ”€โ”€ store/               # Zustand state management
โ”‚   โ”‚   โ””โ”€โ”€ memoryStore.ts
โ”‚   โ”œโ”€โ”€ types/               # TypeScript type definitions
โ”‚   โ”œโ”€โ”€ utils/               # Helper functions
โ”‚   โ”œโ”€โ”€ App.tsx              # Main app with routing
โ”‚   โ””โ”€โ”€ main.tsx             # Entry point
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ tailwind.config.js
โ”œโ”€โ”€ tsconfig.json
โ””โ”€โ”€ vite.config.ts

๐Ÿง  Key Concepts Demonstrated

Memory Types

  • Episodic: Specific events and experiences
  • Semantic: General knowledge and facts
  • Procedural: Skills and how-to knowledge
  • Working: Short-term active processing

Advanced Features

  • Vector Embeddings: Convert text to numerical representations for similarity search
  • Spaced Repetition: Optimal timing for memory reinforcement
  • Memory Consolidation: Merging related memories
  • Knowledge Graphs: Associative memory structures
  • Meta-Cognition: Self-monitoring and optimization

๐Ÿ› ๏ธ Tech Stack

  • React 18 - UI framework
  • Vite - Build tool and dev server
  • TypeScript - Type safety
  • TailwindCSS - Styling
  • Zustand - State management
  • React Router - Navigation
  • Lucide React - Icons

๐Ÿ“ธ Screenshots

Home Page

The main dashboard provides access to all 10 demos with descriptions and quick navigation.

Demo Interface

Each demo includes:

  • Interactive UI components
  • Real-time visualization
  • Educational information panels
  • Hands-on experimentation

๐ŸŽ“ Learning Outcomes

After exploring these demos, you'll understand:

  1. How to implement different memory types in AI agents
  2. Techniques for memory storage and retrieval
  3. Strategies for memory optimization and consolidation
  4. How to visualize memory structures
  5. Best practices for context management in conversations

๐Ÿ”ฎ Future Enhancements

  • Integration with actual LLM backends
  • Persistent memory storage (database)
  • Real vector embeddings (OpenAI, etc.)
  • Export/import memory data
  • Multi-agent memory sharing
  • Memory analytics dashboard

๐Ÿ“„ License

MIT License - feel free to use this for learning and building your own AI agent projects!

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

๐Ÿ“ฌ Contact


Built with โค๏ธ for the AI agent community

About

Interactive AI Agent Memory System Demos - 10 different memory architectures

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages