deployment

Deployment

Lode can run as an installed CLI, a local daemon, or a Docker Compose stack. Release publishing is automated for version tags and manual dispatch through .github/workflows/publish.yml.

Local installation

The package name is lode-kg in pyproject.toml, with console scripts for lode and loded. Developers typically use:

uv tool install lode-kg
uv tool install 'lode-kg[kuzu]'

Docker Compose

docker-compose.yml builds the daemon from Dockerfile, mounts repositories into /repos, and starts a local TEI embedding service. The daemon defaults to 127.0.0.1:7979, while embeddings run on 127.0.0.1:7980 for local smoke tests.

CI and release

Workflow	Purpose
.github/workflows/ci.yml	Validates pushes and pull requests.
.github/workflows/codeql.yml	Runs code scanning.
.github/workflows/publish.yml	Builds and publishes for v* tags or manual dispatch.
.github/workflows/pr-review.yml	Posts PR readiness comments.

Rollback

For a local daemon, stop the process or Compose stack and reinstall a previous package version. The persisted index lives under the data directory from src/lode/config.py, so rollback usually does not require rebuilding the indexed repository unless the schema or fact shape changed.

Related pages

• Getting started
• Tooling
• Configuration