Metadata-Version: 2.4
Name: devmem-agents
Version: 0.1.0
Summary: Standalone team memory gateway for cross-agent development context
Author-email: "C. Steel" <csteel@syntheticore.com>
License-Expression: MIT
Project-URL: Homepage, https://gitlab.com/csteel/devmem
Project-URL: Repository, https://gitlab.com/csteel/devmem
Project-URL: Issues, https://gitlab.com/csteel/devmem/-/issues
Keywords: memory,agents,llm,fastapi,milvus,neptune
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: pydantic>=2.8.0
Requires-Dist: pydantic-settings>=2.4.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: numpy>=1.26.0
Requires-Dist: sqlalchemy>=2.0.0
Provides-Extra: embeddings
Requires-Dist: sentence-transformers>=2.7.0; extra == "embeddings"
Provides-Extra: integration
Requires-Dist: psycopg[binary]>=3.2.0; extra == "integration"
Requires-Dist: boto3>=1.35.0; extra == "integration"
Requires-Dist: urllib3>=2.0.0; extra == "integration"
Requires-Dist: sshtunnel>=0.4.0; extra == "integration"
Requires-Dist: paramiko>=3.4.0; extra == "integration"
Requires-Dist: bcrypt>=4.0.0; extra == "integration"
Requires-Dist: cryptography>=42.0.0; extra == "integration"
Requires-Dist: pymilvus>=2.4.0; extra == "integration"
Requires-Dist: protobuf<7,>=5; extra == "integration"
Provides-Extra: dev
Requires-Dist: pytest>=8.2.0; extra == "dev"
Provides-Extra: publish
Requires-Dist: build>=1.2.0; extra == "publish"
Requires-Dist: twine>=5.1.0; extra == "publish"
Provides-Extra: all
Requires-Dist: devmem-agents[dev,embeddings,integration,publish]; extra == "all"
Dynamic: license-file

# devmem

Standalone developer memory gateway for cross-agent code assistants (Codex, Claude, Gemini, Grok).

`devmem` is intentionally separate from the product codebases it serves. It uses isolated namespaces so development-memory data cannot interfere with existing application data.

## Goals
- Provide one shared API contract for all code assistants.
- Store semantic context in Milvus and relationship/provenance context in Neptune.
- Optionally use Aurora Postgres as control-plane storage in a dedicated schema.
- Enforce namespace isolation (`devlib_v1` by default) on every operation.

## Repo Layout
- `devmem/`: API/service code.
- `docs/`: architecture, plan, deployment, and usage docs.
- `scripts/`: helper CLIs for agents and developers.
- `tests/`: unit tests.

## Quick Start
```bash
git clone <your-fork-or-origin> devmem
cd devmem
python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
uvicorn devmem.main:app --reload --port 8011
```

Or install the published package:
```bash
pip install devmem
uvicorn devmem.main:app --port 8011
```

## Local Configuration

Environment-specific values (live backend endpoints, DSNs, SSH tunnel paths)
live in `devmem.toml` (gitignored). Copy the committed template to get started:

```bash
cp devmem.toml.example devmem.toml
export DEVMEM_LIVE_TOML_PATH="$(pwd)/devmem.toml"
```

Any `DEVMEM_*` environment variable still overrides the TOML.

## Documentation
- **[User Guide](./docs/user-guide.md)** — install, configure, run, and troubleshoot.
- **[Developer Guide](./docs/dev-guide.md)** — contribute, test, publish to PyPI, autostart with systemd.
- [Full docs index](./docs/README.md)
- [`AGENTS.md`](./AGENTS.md) — authoritative coding standards for AI coding assistants working on this repo.
