Skip to content

0.3.3 - 2025-06-07

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Jun 18:06
v0.3.3
fad2e3b

Release Notes

Changed

  • Breaking: OpenAI embedding model selection is now strict — previously, unrecognized model names silently fell back to text-embedding-3-small. Now only text-embedding-3-small and text-embedding-3-large are accepted; other values (e.g. text-embedding-ada-002) produce a clear error. Set EPISTEME_OPENAI_EMBED_MODEL to a supported model name.
  • CLI: explore renamed to search (old name works as deprecated alias)
  • CLI: mcp and api now own their full service lifecycle (start, stop, restart, status, enable [--now], disable [--now])
  • CLI: service top-level command deprecated — use mcp start/stop/restart/status/enable/disable instead
  • CLI: mcp --http deprecated — use mcp start for HTTP daemon mode
  • CLI: launchd-install/uninstall/status deprecated — use mcp enable/disable/status instead
  • enable/disable now cross-platform: macOS (launchd) and Linux (systemd user unit)

Added

  • Host selection and bearer token authentication for MCP HTTP server — configurable bind address (127.0.0.1 or 0.0.0.0) with optional epis- prefixed bearer tokens

  • New mcp.token config field and EPISTEME_MCP_TOKEN environment variable for token-based authentication

  • Server refuses non-localhost binding (0.0.0.0) without a configured token — prevents accidental unauthenticated network exposure

  • Install wizard now includes server configuration step (host selection + optional token generation)

  • Token auto-seeded to MCP client configs (Claude, Cursor, etc.) as Authorization headers and to shell RC files as EPISTEME_MCP_TOKEN

  • api start/stop/restart/status/enable/disable — REST API daemon lifecycle management

  • Linux systemd user unit generation for mcp enable

  • MCP HTTP transport for Claude Code — transport selector TUI, HTTP as default, launchd auto-enable

  • Agent prompt auto-install — epis install copies Episteme agent prompts into ~/.claude/agents/

  • Entity descriptions — description field auto-extracted from markdown source files, shown in web viewer detail panel

  • Benchmark visualization SPA — trend analysis, query breakdown dashboard

  • Web viewer redesign — Sankey diagram layout, sidebar tree, detail panel, subgraph readability improvements

  • MCP config upsert — re-running epis install updates transport when config differs (stdio ↔ HTTP)

  • MCP yaml config — mcp.host / mcp.port in config.yaml (yaml → env fallback)

  • Monitoring — native and remote Prometheus scrape target support via env

  • CI hardening — cargo audit, gitleaks, SBOM generation, pinned action SHAs

  • Release pipeline — Windows target, crates.io publishing, Homebrew tap

  • God module architectural diagnosis example in examples/

Changed

  • Install wizard — all steps (transport, Redis, telemetry) migrated to fullscreen TUI
  • Install flow — auto-builds RAG index after seeding, skips when DB already exists
  • Knowledge graph — enriched with cross-entity semantic relations
  • License — MIT → Apache-2.0

Fixed

  • Tokio runtime panic in synchronous main() for telemetry
  • Search quality — NDCG measurement bug resolved, hit@1 accuracy improved to 100%
  • Search recall — cross-type boosting, sparse entity handling, intent synonyms
  • fastembed model cache pinned to ~/.episteme/models
  • launchd bootstrap UID substitution and port-in-use handling
  • CORS origins now configurable via EPISTEME_CORS_ORIGINS

Install episteme 0.3.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.3/episteme-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/epicsagas/Episteme/releases/download/v0.3.3/episteme-installer.ps1 | iex"

Install prebuilt binaries via Homebrew

brew install epicsagas/tap/episteme

Download episteme 0.3.3

File Platform Checksum
episteme-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
episteme-x86_64-pc-windows-msvc.zip x64 Windows checksum
episteme-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
episteme-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum
Assets 18
Loading