---
name: release
description: Used to release all toolbox, integrations, agents. Use when releasing a subproject to PyPI, Docker Hub, or when the user asks to release or publish.
---

# Release Workflows

All release workflows are triggered via **`workflow_dispatch`** (manual) from the GitHub Actions tab. Bump the version in the subproject's `pyproject.toml` before dispatching.

## Workflow files

| Workflow file                     | Package            | What it does                         | Secrets used                                          |
| --------------------------------- | ------------------ | ------------------------------------ | ----------------------------------------------------- |
| `release-mcp-memgraph.yaml`       | mcp-memgraph       | Build & publish to PyPI + Docker Hub | `PYPI_TOKEN`, `DOCKERHUB_USERNAME`, `DOCKERHUB_TOKEN` |
| `release-toolbox.yaml`            | memgraph-toolbox   | Build & publish to PyPI              | `PYPI_TOKEN`                                          |
| `release-langchain-memgraph.yaml` | langchain-memgraph | Build & publish to PyPI              | `PYPI_TOKEN`                                          |
| `release-lightrag-memgraph.yaml`  | lightrag-memgraph  | Build & publish to PyPI              | `PYPI_TOKEN`                                          |
| `release-unstructured2graph.yaml` | unstructured2graph | Build & publish to PyPI              | `PYPI_TOKEN`                                          |

## Subproject paths

| Package            | Path                              | pyproject.toml version field |
| ------------------ | --------------------------------- | ---------------------------- |
| memgraph-toolbox   | `memgraph-toolbox`                | `[project] version`          |
| mcp-memgraph       | `integrations/mcp-memgraph`       | `[project] version`          |
| langchain-memgraph | `integrations/langchain-memgraph` | `[project] version`          |
| lightrag-memgraph  | `integrations/lightrag-memgraph`  | `[project] version`          |
| unstructured2graph | `unstructured2graph`              | `[project] version`          |

## Required GitHub secrets

| Secret               | Used by                | Description                     |
| -------------------- | ---------------------- | ------------------------------- |
| `PYPI_TOKEN`         | All release workflows  | PyPI API token for `uv publish` |
| `DOCKERHUB_USERNAME` | `release-mcp-memgraph` | Docker Hub username             |
| `DOCKERHUB_TOKEN`    | `release-mcp-memgraph` | Docker Hub access token         |

## Notes

- **lightrag-memgraph** and **unstructured2graph** use `uv build --out-dir dist` to work around a uv artifact path issue.
- The **mcp-memgraph** Docker image is built from the repo root (the Dockerfile copies both `memgraph-toolbox/` and `integrations/mcp-memgraph/`).
- The mcp-memgraph workflow tags the Docker image with both the version and `latest`.