Metadata-Version: 2.4
Name: lummenna
Version: 1.0.1rc4
Summary: Twin-force memory and context framework for sovereign AI agents
Project-URL: Homepage, https://lummenna.com
Project-URL: Documentation, https://lummenna.com/docs
Author-email: QuantumindSSI <support@lummenna.com>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
License-File: LICENSES/AGPL-3.0.txt
License-File: LICENSES/Apache-2.0.txt
License-File: THIRD_PARTY_NOTICES.md
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <3.13,>=3.10
Requires-Dist: apscheduler>=3.10
Requires-Dist: cryptography>=42.0
Requires-Dist: fastapi>=0.110
Requires-Dist: huggingface-hub>=0.20
Requires-Dist: jinja2>=3.1
Requires-Dist: msgspec>=0.18
Requires-Dist: networkx>=3.0
Requires-Dist: numba>=0.59
Requires-Dist: numpy>=1.26
Requires-Dist: onnxruntime>=1.17
Requires-Dist: psutil>=5.9
Requires-Dist: pydantic-settings>=2.2
Requires-Dist: pydantic>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: scikit-learn>=1.4
Requires-Dist: slowapi>=0.1.9
Requires-Dist: sqlcipher3>=0.6; platform_machine == 'x86_64' or platform_machine == 'aarch64'
Requires-Dist: sqlite-vec>=0.1.0
Requires-Dist: structlog>=24.1
Requires-Dist: transformers>=4.36
Requires-Dist: typer>=0.12
Requires-Dist: usearch>=2.0
Requires-Dist: uvicorn[standard]>=0.29
Requires-Dist: zeroconf>=0.132
Provides-Extra: azure
Requires-Dist: azure-identity>=1.16; extra == 'azure'
Requires-Dist: azure-monitor-opentelemetry>=1.6; extra == 'azure'
Requires-Dist: azure-storage-blob>=12.19; extra == 'azure'
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.48b0; extra == 'azure'
Provides-Extra: benchmarks
Requires-Dist: datasets>=2.0; extra == 'benchmarks'
Requires-Dist: ir-measures>=0.3; extra == 'benchmarks'
Requires-Dist: pytrec-eval>=0.5; extra == 'benchmarks'
Requires-Dist: rank-bm25>=0.2.2; extra == 'benchmarks'
Requires-Dist: scipy>=1.10; extra == 'benchmarks'
Requires-Dist: sentence-transformers>=2.0; extra == 'benchmarks'
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: mypy>=1.8; extra == 'dev'
Requires-Dist: pre-commit>=3.6; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.3.0; extra == 'dev'
Provides-Extra: export
Requires-Dist: optimum[onnxruntime]>=1.17; extra == 'export'
Provides-Extra: full
Requires-Dist: llama-cpp-python>=0.2.0; (platform_machine == 'aarch64' or platform_machine == 'x86_64') and extra == 'full'
Requires-Dist: mcp<2.0,>=1.29; extra == 'full'
Requires-Dist: optimum[onnxruntime]>=1.17; extra == 'full'
Requires-Dist: spacy>=3.7; extra == 'full'
Provides-Extra: langchain
Requires-Dist: langchain>=0.3; extra == 'langchain'
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.2; extra == 'langgraph'
Provides-Extra: localllm
Requires-Dist: llama-cpp-python>=0.2.0; (platform_machine == 'aarch64' or platform_machine == 'x86_64') and extra == 'localllm'
Provides-Extra: mcp
Requires-Dist: mcp<2.0,>=1.29; extra == 'mcp'
Provides-Extra: release
Requires-Dist: build<2,>=1.6; extra == 'release'
Requires-Dist: twine<8,>=7; extra == 'release'
Provides-Extra: security
Requires-Dist: bandit[toml]<2,>=1.9; extra == 'security'
Requires-Dist: pip-audit<3,>=2.10; extra == 'security'
Requires-Dist: pip-licenses<6,>=5.5; extra == 'security'
Provides-Extra: wizard
Requires-Dist: spacy>=3.7; extra == 'wizard'
Description-Content-Type: text/markdown

# Lummenna Community 1.0.1rc4

Lummenna is a local-first memory and context framework for AI agents. This
Community build is a public release candidate prepared for PyPI and direct
distribution by `lummenna.com`. Its Python API may change before a stable release.

## Install

Lummenna supports Python 3.10 through 3.12. After publication, install this
prerelease with the MCP server and one-time model export tools:

```bash
uv tool install --python 3.12 "lummenna[mcp,export]==1.0.1rc4"
```

This installs both `lummenna` and `lummenna-mcp` in the same isolated tool
environment.

For a project environment managed by pip, use
`python -m pip install --pre "lummenna[mcp,export]==1.0.1rc4"`.

For a package-index-independent installation, download the same wheel directly:

```bash
curl --fail --show-error --silent --remote-name \
  https://lummenna.com/downloads/lummenna-1.0.1rc4-py3-none-any.whl
python -m pip install "./lummenna-1.0.1rc4-py3-none-any.whl[mcp,export]"
```

Verify direct downloads against the published checksums:

```text
https://lummenna.com/downloads/SHA256SUMS-1.0.1rc4
```

The corresponding source archive is available at:

```text
https://lummenna.com/downloads/lummenna-1.0.1rc4.tar.gz
```

The source archive includes `uv.lock`. For a locked deployment, verify and
extract the archive, then run:

```bash
uv sync --locked --no-dev --extra mcp --extra export
```

## Initialize And Run

The embedding model is not bundled with the package. Provision it once before
starting the service:

```bash
lummenna init --device generic
LUMMENNA_SOVEREIGN=false lummenna model download bge-small-en-v1.5
lummenna serve --host 127.0.0.1 --port 8848
```

The dashboard is then available at `http://localhost:8848/`. Set
`LUMMENNA_API_KEY` before exposing the API beyond localhost.

Run the stdio MCP server from the same environment:

```bash
lummenna-mcp
```

## Sidecar Deployment

The complete, checksum-pinned Community sidecar procedure is published at
`https://lummenna.com/community`.

## License And Contact

The Community Edition is licensed under AGPL-3.0-or-later. Network deployment
of a modified build carries the AGPL corresponding-source obligations described
in `LICENSE`.

- Support: `support@lummenna.com`
