Metadata-Version: 2.4
Name: mag-memory
Version: 0.1.4
Summary: PyPI wrapper for the mag MCP memory server (Rust binary)
Project-URL: Homepage, https://github.com/George-RD/mag
Project-URL: Repository, https://github.com/George-RD/mag
Project-URL: Issues, https://github.com/George-RD/mag/issues
Author: George-RD
License-Expression: MIT
Keywords: ai,llm,mcp,memory,semantic-search,sqlite
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# mag-memory

PyPI wrapper for [mag](https://github.com/George-RD/mag), a Rust-based MCP memory server.

mag stores memories in SQLite with ONNX embeddings for semantic search, exposing 16 MCP tools via stdio protocol. No external services required.

## Installation

```bash
pip install mag-memory
```

## Usage

```bash
# Start the MCP server
mag serve

# The native binary is downloaded automatically on first run.
# All CLI arguments are passed through to the Rust binary.
```

## How it works

This package does not bundle the native binary. On first run, it detects your platform (Linux/macOS/Windows, x86_64/ARM64), downloads the correct prebuilt binary from [GitHub Releases](https://github.com/George-RD/mag/releases), and caches it locally. Subsequent runs use the cached binary with zero overhead (Unix `exec`).

## Supported platforms

| OS      | Architecture |
|---------|-------------|
| Linux   | x86_64, aarch64 |
| macOS   | x86_64, Apple Silicon (aarch64) |
| Windows | x86_64 |

## License

MIT
