Skip to main content

AI Memory Platform SDK - Give any AI human-like memory

Project description

Stellar Memory

Give your AI the ability to remember. Free & open-source.

PyPI Tests License

What is Stellar Memory?

Stellar Memory gives any AI the ability to remember things across conversations. Once your AI learns something about you, it remembers it next time — just like a person.

No programming required. Works with Claude Desktop, Cursor, and any MCP-compatible AI.

Get Started (2 options)

Option 1: Install on your computer (Recommended)

Windows:

  1. Download stellar-memory-setup.bat
  2. Double-click to run
  3. Restart Claude Desktop or Cursor
  4. Done! Try saying: "Remember my name is ___"

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/sangjun0000/stellar-memory/main/stellar-memory-setup.sh | bash

Or if you have Python:

pip install stellar-memory[mcp]
stellar-memory setup

Option 2: Use in the cloud

Cloud service coming soon. You'll be able to use Stellar Memory from any browser without installing anything.

For now, developers can use the REST API — see API docs.

How it works

You: "My favorite color is blue. Remember that."
AI:  "Got it! I'll remember that your favorite color is blue."

... next conversation ...

You: "What's my favorite color?"
AI:  "Your favorite color is blue!"

Stellar Memory organizes memories like a solar system:

  • Core — Most important, always remembered
  • Inner — Important, frequently accessed
  • Outer — Regular memories
  • Belt — Less important
  • Cloud — Rarely accessed, may fade

For Developers

Click to expand developer documentation

Python Library

from stellar_memory import StellarMemory

memory = StellarMemory()
memory.store("User prefers dark mode", importance=0.8)
results = memory.recall("user preferences")
memory.stop()

Installation Options

pip install stellar-memory          # Core library
pip install stellar-memory[mcp]     # With MCP server
pip install stellar-memory[server]  # With REST API
pip install stellar-memory[full]    # Everything

Key Features

  • 5-Zone Hierarchy — Core, Inner, Outer, Belt, Cloud
  • Adaptive Decay — Memories naturally fade like human memory
  • Emotion Engine — 6-dimensional emotion vectors
  • Self-Learning — Optimizes based on usage patterns
  • MCP Server — Claude Code, Cursor integration
  • REST API — Full HTTP API with Swagger docs
  • Vector Search — Semantic similarity matching
  • Graph Analytics — Memory relationships and communities
  • Multi-Agent Sync — CRDT-based conflict resolution

Requirements

Python 3.10+

Documentation

License

MIT License — free to use, modify, and distribute.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stellar_memory-3.0.0.tar.gz (185.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stellar_memory-3.0.0-py3-none-any.whl (165.3 kB view details)

Uploaded Python 3

File details

Details for the file stellar_memory-3.0.0.tar.gz.

File metadata

  • Download URL: stellar_memory-3.0.0.tar.gz
  • Upload date:
  • Size: 185.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.3

File hashes

Hashes for stellar_memory-3.0.0.tar.gz
Algorithm Hash digest
SHA256 56c03614e17a979d9e977a615cb82688f5df23c0a0943af8e567ec9ec438b0d2
MD5 a7e755a07a0f6e6934d33f42f1700158
BLAKE2b-256 82f9cef63d900d6d07d16bcc08247e31d513b98a6b271fe7da26b2dad824a1f5

See more details on using hashes here.

File details

Details for the file stellar_memory-3.0.0-py3-none-any.whl.

File metadata

  • Download URL: stellar_memory-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 165.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.3

File hashes

Hashes for stellar_memory-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4d9920cad99392fb75069fcf05f8c04b1aa796da0236ca4e91fef9c4733ddbca
MD5 aae24984a22bfc9fdbd2ab6ebdc7a3af
BLAKE2b-256 28e8ccf6a31ae9b2374d44e1ea8f97144efca13f3ea18f4917aeebd9e7fe1915

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page