Skip to content

Installation

Python

Basic Installation

pip install alma-memory

With Optional Backends

# Local development (SQLite + FAISS + local embeddings)
pip install alma-memory[local]

# Production databases
pip install alma-memory[postgres]   # PostgreSQL + pgvector
pip install alma-memory[qdrant]     # Qdrant vector database
pip install alma-memory[pinecone]   # Pinecone vector database
pip install alma-memory[chroma]     # ChromaDB

# Enterprise
pip install alma-memory[azure]      # Azure Cosmos DB + Azure OpenAI

# Everything
pip install alma-memory[all]

Requirements

  • Python 3.10 or higher
  • pip 21.0 or higher

TypeScript / JavaScript

Via GitHub Packages

# Configure npm for the scope (one-time)
echo "@rbkunnela:registry=https://npm.pkg.github.com" >> ~/.npmrc

# Install
npm install @rbkunnela/alma-memory

Or with yarn:

yarn add @rbkunnela/alma-memory

Requirements

  • Node.js 18.0.0 or higher (for native fetch support)
  • A running ALMA MCP server for the TypeScript SDK to connect to

Verify Installation

from alma import ALMA, __version__
print(f"ALMA version: {__version__}")

import { ALMA, VERSION } from '@rbkunnela/alma-memory';
console.log(`ALMA version: ${VERSION}`);

Next Steps