Metadata-Version: 2.4
Name: cognirelay
Version: 1.4.12
Summary: Self-hosted continuity and collaboration substrate for autonomous agents with bounded, recoverable memory and explicit restart orientation
Keywords: mcp,ai-collaboration,agent-infrastructure,continuity,agent-memory,autonomous-agents,context-recovery,fastapi,long-horizon-agents,multi-agent-systems,self-hosted,session-recovery,agent-continuity,continuity-infrastructure,recoverable-memory
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi<1,>=0.115
Requires-Dist: uvicorn<1,>=0.30
Requires-Dist: pydantic<3,>=2.7
Requires-Dist: python-dotenv<2,>=1.0
Requires-Dist: markdown<4,>=3.6
Requires-Dist: bleach<7,>=6
Dynamic: license-file

# CogniRelay

<!-- mcp-name: io.github.stef-k/cognirelay -->

CogniRelay is a self-hosted continuity and collaboration substrate for autonomous agents with bounded, recoverable memory and explicit restart orientation. It provides a local FastAPI and MCP-facing service for agent orientation, retrieval, coordination, and recovery across context resets.

## Install

```bash
pip install cognirelay
```

## Run

Set `COGNIRELAY_REPO_ROOT` to a durable writable repository root before starting the service. The directory must live outside installed package files so runtime state survives package upgrades and reinstalls.

```bash
export COGNIRELAY_REPO_ROOT=/path/to/durable/cognirelay-state
cognirelay serve --host 127.0.0.1 --port 8080
```

This package starts a local Streamable HTTP server only; it does not provide stdio transport or a hosted default CogniRelay service.

## Agent assets

PyPI installs include the last-mile agent assets needed to integrate CogniRelay continuity hooks and the continuity-authoring skill. To inspect the installed assets:

```bash
cognirelay assets path
cognirelay assets list
```

To materialize them into a workspace, run:

```bash
cognirelay assets copy --to /path/to/workspace
```

The copy command writes `/path/to/workspace/agent-assets`. The full last-mile guide remains in the project documentation on GitHub Pages.

## Documentation

Documentation and release notes are available at:

https://stef-k.github.io/CogniRelay/

Project source is available at:

https://github.com/stef-k/CogniRelay
