Metadata-Version: 2.5
Name: memini-ai
Version: 0.1.1
Summary: Local-first memory server for AI coding agents. Three MCP tools, pgvector + full-text search.
Author: VeeDubin
License: MIT
License-File: LICENSE
Keywords: agents,mcp,memory,pgvector
Requires-Python: >=3.12
Requires-Dist: asyncpg>=0.30
Requires-Dist: fastmcp>=3.0
Requires-Dist: pgvector>=0.3
Requires-Dist: pydantic-settings>=2.3
Requires-Dist: pydantic>=2.7
Requires-Dist: sentence-transformers>=3.0
Requires-Dist: structlog>=24.0
Requires-Dist: torch>=2.2
Provides-Extra: dev
Requires-Dist: mkdocs-material>=9.5; extra == 'dev'
Requires-Dist: mkdocs<2; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# memini-ai

Local-first memory for AI coding agents. Three MCP tools: `remember`, `recall`, `orient`.
Postgres + pgvector for storage, BGE-M3 embeddings on CPU, hybrid vector + full-text search.

## Quick start

    uv tool install memini-ai --index https://download.pytorch.org/whl/cpu --index-strategy unsafe-best-match
    memini-ai db up            # pgvector/pgvector:pg18 on 127.0.0.1:5555
    memini-ai migrate          # optional; serve applies migrations on first connection
    memini-ai warm             # one-time ~2.2 GB BGE-M3 download, then embeds one string

The `--index` flags install CPU torch instead of the default CUDA build. Run `warm` before wiring
up a client: the first `remember` or `recall` would otherwise download BGE-M3 (about 2.2 GB) inside
a tool call and time out until it finishes.

Then, from the project you want memory for:

    cd ~/Projects/my-repo
    memini-ai init --client claude-code --project my-repo

Restart the client and call `orient`.

## Docs

- [Getting started](docs/getting-started.md)
- [The three tools](docs/tools.md)
- [Configuration](docs/configuration.md)
- [Clients and the init-memini skill](docs/clients.md)
- [Session ingest](docs/session-ingest.md)
- [Architecture](docs/architecture.md)
- [Changelog](docs/changelog.md)

## License

MIT. See [LICENSE](LICENSE).
