Skip to content

PowerMem v0.3.0

Choose a tag to compare

View all tags
@Teingi Teingi released this 09 Jan 03:32
v0.3.0
316cb29
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

PowerMem 0.3.0 Release Notes

Release Date: January 9, 2026

We're excited to announce the release of PowerMem 0.3.0! This version introduces a production-ready HTTP API Server and comprehensive Docker support, making PowerMem accessible to any application that supports HTTP calls, regardless of programming language.

🎉 Major Features

🌐 Production-Ready HTTP API Server

PowerMem now provides a fully-featured HTTP API Server built with FastAPI, exposing all core memory management capabilities through RESTful APIs. This enables seamless integration with any application that supports HTTP calls.

Key Features

  • RESTful API Endpoints: Complete REST API for all memory operations

    • Memory management (create, read, update, delete, search)
    • Batch operations for efficient bulk processing
    • User profile management
    • Agent memory management and sharing
    • System health and status monitoring

  • Security & Authentication

    • API Key authentication with configurable keys
    • Rate limiting to protect server resources (configurable per IP)
    • CORS support for web applications

  • Production Features

    • Health check endpoint for monitoring
    • System status and metrics endpoints
    • Prometheus-compatible metrics format
    • Configurable worker processes for scalability

API Endpoints Overview

System Endpoints

  • GET /api/v1/system/health - Health check (public endpoint)
  • GET /api/v1/system/status - System status and configuration
  • GET /api/v1/system/metrics - Prometheus metrics
  • DELETE /api/v1/system/delete-all-memories - Bulk memory deletion

Memory Management Endpoints

  • POST /api/v1/memories - Create memory (with intelligent extraction)
  • POST /api/v1/memories/batch - Batch create memories
  • GET /api/v1/memories - List memories with pagination
  • GET /api/v1/memories/{memory_id} - Get specific memory
  • PUT /api/v1/memories/{memory_id} - Update memory
  • PUT /api/v1/memories/batch - Batch update memories
  • DELETE /api/v1/memories/{memory_id} - Delete memory
  • DELETE /api/v1/memories/batch - Bulk delete memories
  • POST /api/v1/memories/search - Semantic search with hybrid retrieval

User Profile Endpoints

  • POST /api/v1/users/{user_id}/profile - Create or update user profile
  • GET /api/v1/users/{user_id}/profile - Get user profile
  • DELETE /api/v1/users/{user_id}/profile - Delete user profile
  • GET /api/v1/users/{user_id}/memories - Get all user memories
  • DELETE /api/v1/users/{user_id}/memories - Delete all user memories

Agent Management Endpoints

  • POST /api/v1/agents/{agent_id}/memories - Create agent memory
  • GET /api/v1/agents/{agent_id}/memories - Get agent memories
  • POST /api/v1/agents/{agent_id}/memories/share - Share memories between agents
  • GET /api/v1/agents/{agent_id}/memories/share - Get shared memories

Quick Start

# Install PowerMem
pip install powermem

# Start the API server
powermem-server --host 0.0.0.0 --port 8000

# Access interactive API documentation
# Open http://localhost:8000/docs in your browser

🐳 Docker Support

Comprehensive Docker support for easy deployment and containerization, making PowerMem production-ready for containerized environments.

Features

  • Dockerfile: Production-optimized multi-stage build

    • Minimal image size
    • Non-root user for security
    • Health check support
    • Configurable build arguments for mirror sources

  • Docker Compose: Pre-configured setup for easy deployment

    • Automatic environment variable loading
    • Shared .env file support (SDK and Server)
    • Health checks and auto-restart
    • Logging configuration

  • Production-Ready Configuration

    • Resource limits support
    • Health check endpoints
    • Structured logging with rotation
    • Security best practices

Quick Start with Docker

# Using Docker
docker run -d \
  --name powermem-server \
  -p 8000:8000 \
  -v $(pwd)/.env:/app/.env:ro \
  --env-file .env \
  oceanbase/powermem-server:latest

# Using Docker Compose (recommended)
docker-compose -f docker/docker-compose.yml up -d

📋 Configuration

The HTTP API Server shares the same configuration file (.env) as the PowerMem SDK, ensuring consistency between SDK and API server usage. New configuration sections have been added:

Server Configuration

# Server Settings
POWERMEM_SERVER_HOST=0.0.0.0
POWERMEM_SERVER_PORT=8000
POWERMEM_SERVER_WORKERS=4
POWERMEM_SERVER_RELOAD=false

# Authentication
POWERMEM_SERVER_AUTH_ENABLED=false
POWERMEM_SERVER_API_KEYS=key1,key2,key3

# Rate Limiting
POWERMEM_SERVER_RATE_LIMIT_ENABLED=true
POWERMEM_SERVER_RATE_LIMIT_PER_MINUTE=100

# Logging
POWERMEM_SERVER_LOG_FILE=server.log
POWERMEM_SERVER_LOG_LEVEL=INFO
POWERMEM_SERVER_LOG_FORMAT=text

# CORS
POWERMEM_SERVER_CORS_ENABLED=true
POWERMEM_SERVER_CORS_ORIGINS=*

🔄 Migration Guide

From 0.2.0 to 0.3.0

No breaking changes to the SDK! The HTTP API Server is an additional feature that doesn't affect existing SDK usage.

If you want to use the HTTP API Server:

  1. Update PowerMem to 0.3.0:

    pip install --upgrade powermem

  2. Add server configuration to your .env file (see Configuration section above)

  3. Start the API server:

    powermem-server --host 0.0.0.0 --port 8000

Existing SDK code continues to work without any changes.

📚 Documentation

📦 Dependencies

New Dependencies

  • fastapi>=0.100.0 - Web framework for the API server
  • uvicorn>=0.23.0 - ASGI server
  • slowapi>=0.1.9 - Rate limiting middleware
  • click>=8.0.0 - CLI framework

Updated Dependencies

  • All existing dependencies remain compatible
  • No breaking changes to existing dependencies

🙏 Acknowledgments

Thank you to all contributors and users who provided feedback and helped improve PowerMem!

Full Changelog: For a complete list of changes, see the GitHub Releases page.

Full Changelog: v0.2.1...v0.3.0

Assets 4
Loading