diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2c6b1819..1edf6a66 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
+---
+
+## [0.5.1] - 2026-06-29
+
### Added
- **Apache Arrow & Feather File Ingestion** (#705) by @Luffy2208
@@ -24,6 +28,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Optional dependency group: `pip install semantica[ingest-arrow]`; included in `pip install semantica[all]`
- 34 tests covering schema extraction, metadata inspection, row limits, column selection, multi-batch reading, IPC stream format, Feather ingestion, empty datasets, null values, magic-byte detection, and failure modes
+- **Knowledge Explorer Deployment Templates** (#684) by @ZohaibHassan16 and @KaifAhmad1
+ - Added `deploy/` directory with ready-to-use templates for 7 platforms, closing #681
+ - **Docker** — fixed `Dockerfile` path (was broken on clean checkout), added non-root user, `HEALTHCHECK`, `.dockerignore`; fixed `docker-compose.yml` to start Explorer alongside FalkorDB on a shared network; added `docker-compose.dev.yml` with source volume-mounts for hot-reload (`docker compose up` brings up the full stack in one command)
+ - **Railway** — `deploy/railway/railway.toml` with Dockerfile builder, healthcheck path, restart policy, and env vars wired from the Railway Redis plugin
+ - **Render** — `deploy/render/render.yaml` Blueprint provisioning the web service and a Redis instance together with cross-linked env vars
+ - **Fly.io** — `deploy/fly/fly.toml` with region, 512 MB VM, auto-stop, HTTP healthcheck, and a short README with four `flyctl` commands to deploy from zero
+ - **GCP Cloud Run** — `deploy/gcp/cloudbuild.yaml` (build → push → deploy pipeline) and `deploy/gcp/cloudrun-service.yaml` (scale-to-zero, Secret Manager env vars, liveness probe)
+ - **Azure Container Apps** — `deploy/azure/azure.yaml`, `main.bicep` (Container App + managed environment, HTTP ingress, HPA min 0 / max 10, liveness probe), and `main.parameters.json`; deployable with `azd up`
+ - **Kubernetes + Helm** — raw manifests (`namespace`, `configmap`, `secret.example`, `deployment` with 2 replicas + rolling update, `service`, `ingress` with cert-manager TLS, `kustomization`); Helm chart with `Chart.yaml`, `values.yaml`, `values.prod.yaml`, HPA template, and `helm lint`-passing templates; all templates carry `namespace: {{ .Release.Namespace }}`
+ - Added `/api/health` endpoint returning `{"status": "ok"}` used by all platform healthchecks
+ - Wired `ALLOWED_ORIGINS`, `FALKORDB_HOST`, and `FALKORDB_PORT` from environment variables in `semantica/explorer/app.py`
+ - Security hardened: non-root containers, `readOnlyRootFilesystem`, `NetworkPolicy` with explicit ingress/egress selectors, `seccompProfile: RuntimeDefault`, capabilities dropped; secrets via `secret.yaml.example` templates only — no committed credentials
+
### Fixed
- **Arrow ingestion double full-scan on every data read** (#705) by @KaifAhmad1
diff --git a/deploy/helm/knowledge-explorer/Chart.yaml b/deploy/helm/knowledge-explorer/Chart.yaml
index b0b64c0a..a58af3f0 100644
--- a/deploy/helm/knowledge-explorer/Chart.yaml
+++ b/deploy/helm/knowledge-explorer/Chart.yaml
@@ -3,4 +3,4 @@ name: knowledge-explorer
description: Semantica Knowledge Explorer deployment chart
type: application
version: 0.1.0
-appVersion: "0.5.0"
+appVersion: "0.5.1"
diff --git a/deploy/helm/knowledge-explorer/values.prod.yaml b/deploy/helm/knowledge-explorer/values.prod.yaml
index ee6e10bb..cbb4817a 100644
--- a/deploy/helm/knowledge-explorer/values.prod.yaml
+++ b/deploy/helm/knowledge-explorer/values.prod.yaml
@@ -2,7 +2,7 @@ image:
repository: ghcr.io/semantica-agi/semantica-knowledge-explorer
# Replace this placeholder digest with the digest of the image you publish.
digest: "sha256:0000000000000000000000000000000000000000000000000000000000000000"
- tag: "0.5.0"
+ tag: "0.5.1"
pullPolicy: Always
ingress:
diff --git a/docs/citation.md b/docs/citation.md
index dce248d7..98362a4f 100644
--- a/docs/citation.md
+++ b/docs/citation.md
@@ -17,22 +17,22 @@ icon: "quote-left"
author = {Hawksight AI},
year = {2026},
url = {https://github.com/semantica-agi/semantica},
- version = {0.5.0},
+ version = {0.5.1},
doi = {10.5281/zenodo.XXXXXXX}
}
```
- Hawksight AI. (2026). *Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering* (Version 0.5.0) \[Computer software\]. https://github.com/semantica-agi/semantica
+ Hawksight AI. (2026). *Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering* (Version 0.5.1) \[Computer software\]. https://github.com/semantica-agi/semantica
- Hawksight AI. *Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering*. Version 0.5.0, GitHub, 2026, https://github.com/semantica-agi/semantica.
+ Hawksight AI. *Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering*. Version 0.5.1, GitHub, 2026, https://github.com/semantica-agi/semantica.
- Hawksight AI. *Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering*. Version 0.5.0. GitHub, 2026. https://github.com/semantica-agi/semantica.
+ Hawksight AI. *Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering*. Version 0.5.1. GitHub, 2026. https://github.com/semantica-agi/semantica.
- Hawksight AI, "Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering," Version 0.5.0, GitHub, 2026. \[Online\]. Available: https://github.com/semantica-agi/semantica
+ Hawksight AI, "Semantica: An Open Source Framework for Semantic Layers and Knowledge Engineering," Version 0.5.1, GitHub, 2026. \[Online\]. Available: https://github.com/semantica-agi/semantica
diff --git a/docs/faq.md b/docs/faq.md
index afe0c09a..108ab720 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -17,7 +17,7 @@ icon: "circle-question"
| API key required? | Optional: pattern extraction works with no keys |
| Works with LangChain / LlamaIndex? | Yes: Semantica is a layer on top, not a replacement |
| Production-ready? | Yes: 1,000+ tests, v0.5.0 ships with 12 security fixes |
-| Latest version? | **v0.5.0** (May 2026) |
+| Latest version? | **v0.5.1** (June 2026) |
| Local LLMs? | Yes: Ollama via LiteLLM, HuggingFaceLLM for air-gapped |
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 5095fb59..f6550721 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -42,7 +42,7 @@ icon: "rocket"
Verify installation:
```python
import semantica
- print(semantica.__version__) # 0.5.0
+ print(semantica.__version__) # 0.5.1
```
diff --git a/pyproject.toml b/pyproject.toml
index 7570b643..bc74775e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "semantica"
-version = "0.5.0"
+version = "0.5.1"
description = "Accountability and context layer for AI agents. Context graphs, decision intelligence, full provenance tracking, and explainable reasoning engines — every AI decision traceable, every output auditable."
readme = "README.md"
license = { text = "MIT" }
diff --git a/semantica/__init__.py b/semantica/__init__.py
index acc9a492..e61e623b 100644
--- a/semantica/__init__.py
+++ b/semantica/__init__.py
@@ -10,7 +10,7 @@ Main exports:
- Config: Configuration management
"""
-__version__ = "0.5.0"
+__version__ = "0.5.1"
__author__ = "Semantica Contributors"
__license__ = "MIT"