Memorizer

Memorizer is a .NET-based service that allows AI agents to store, retrieve, and search through memories using vector embeddings. It leverages PostgreSQL with the pgvector extension to provide efficient similarity search capabilities.

Key features:

• Workspaces & Projects - Organize memories into hierarchical workspaces and projects with status tracking
• Store structured memories with vector embeddings
• Retrieve memories by ID
• Semantic search through memories using vector similarity
• Filter search results using tags
• Edit memory content with automatic versioning and change tracking
• Update memory metadata (title, type, tags, confidence) independently
• Revert memories to previous versions with full audit trail
• Create relationships between memories to form knowledge graphs
• Web UI for manually adding, editing, deleting, viewing memories, and managing versions
• Provider Settings - Configure embedding and LLM providers through the UI (Ollama, OpenAI, and compatible APIs)
• MCP (Model Context Protocol) integration for easy use with AI agents

Technologies

• .NET 10.0
• PostgreSQL with pgvector extension
• Model Context Protocol (MCP)
• ASP.NET Core
• Akka.NET for background jobs, such as re-embedding memories if you change algorithms
• Npgsql for PostgreSQL connectivity

📖 Documentation

• Feature Gallery (Screenshots)
• Configuration & Advanced Setup
• Security Configuration
• Embedding Models & Dimensions
• Embedding Dimension Migration
• Local Development
• Schema Migrations
• Architecture Decision Records

Installation with Docker

🐳 Quick Start (Public Image)

The easiest way to get started is using the pre-built Docker image and our docker-compose.yml file:

docker-compose up -d

This will:

• Download and run the latest petabridge/memorizer image from Docker Hub
• Start PostgreSQL with pgvector (port 5432)
• Start PgAdmin (port 5050)
• Start Ollama (port 11434)
• Start Memorizer API (port 5000)

View the Memorizer Web UI on http://localhost:5000.

🚀 Local Development Builds

If you want to build and run from source:

Prerequisites

• Docker and Docker Compose
• .NET 10.0 SDK

1. Build and Publish Local Container

# From solution root directory
# Build and publish the .NET container
dotnet publish -c Release /t:PublishContainer

This creates a container image named memorizer:latest.

2. Start Infrastructure and Application

docker-compose -f docker-compose.local.yml up -d

This starts the same services but uses your locally built image.

Upgrading to Memorizer 2.0

> [!NOTE] > The upgrade from Memorizer 1.x to 2.0 is designed to work automatically. All schema migrations run on startup and have been thoroughly tested. Your existing memories will be preserved and continue to work as expected.

> [!CAUTION] > We recommend backing up your database before upgrading, as a standard best practice. Memorizer 2.0 runs automatic schema migrations on startup that alter tables and add new columns. While we've tested these migrations extensively, having a backup ensures you can recover in the unlikely event that something goes wrong.

Backup Instructions

> [!NOTE] > The container names below (e.g., memorizer-postgres) are based on the default docker-compose.yml. If you've customized your Docker Compose file, adjust the container name accordingly.

Before pulling the new Memorizer 2.0 image, create a PostgreSQL dump of your existing database:

# Create a full database backup
docker exec postgmem-postgres pg_dump -U postgres postgmem > memorizer-backup-$(date +%Y%m%d).sql

# Or use pg_dump with compression
docker exec postgmem-postgres pg_dump -U postgres -Fc postgmem > memorizer-backup-$(date +%Y%m%d).dump

To restore from a backup if needed:

# Restore from SQL dump
docker exec -i postgmem-postgres psql -U postgres postgmem < memorizer-backup-20250207.sql

# Or restore from compressed dump
docker exec -i postgmem-postgres pg_restore -U postgres -d postgmem memorizer-backup-20250207.dump