Releases: epicsagas/Episteme
Release list
v0.3.9
Install episteme 0.3.9
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.9/episteme-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/epicsagas/Episteme/releases/download/v0.3.9/episteme-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.9
| 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 |
v0.3.8
Install episteme 0.3.8
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.8/episteme-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/epicsagas/Episteme/releases/download/v0.3.8/episteme-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.8
| 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 |
v0.3.7
Install episteme 0.3.7
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.7/episteme-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/epicsagas/Episteme/releases/download/v0.3.7/episteme-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.7
| 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 |
0.3.6 — 2026-06-10
Release Notes
Added
- Evaluation testset and batch evaluation system for search quality regression detection
- Knowledge graph consolidated into SQLite for unified storage (
feat(db)) - Dashboard rewrite with i18n help modals
Fixed
- SMELL-16 (Comments) false positive elimination — doc comments (docstrings,
///,/** Javadoc */) are now excluded from inline comment counting via a newdoc_comment_countfield inCodeMetrics - Python AST parser LOC calculation — multi-line docstring content lines no longer counted as code lines
- Rust/Go regex parser position mismatch — comment counts are now pre-collected from raw (unstripped) code instead of incorrectly indexing into comment-stripped code
- Search: homonym layer priority swapped to fix Python query false positives
- Search: value objects excluded from lazy class tier 2 detection
- Search: homonym lookup hardened and smell detector accuracy improved
- CI: eval workflow now seeds graph data before evaluation (fixes traversal/search 0% scores)
Changed
- Eval composite score improved to 0.7996, regression PASS
- Benchmarks:
eval_runnerupdated to usesearchcommand - Bump
actions/setup-pythonfrom 5 to 6
Install episteme 0.3.6
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.6/episteme-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/epicsagas/Episteme/releases/download/v0.3.6/episteme-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.6
| 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 |
v0.3.5
Install episteme 0.3.5
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.5/episteme-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/epicsagas/Episteme/releases/download/v0.3.5/episteme-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.5
| 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 |
0.3.3 - 2025-06-07
Release Notes
Changed
- Breaking: OpenAI embedding model selection is now strict — previously, unrecognized model names silently fell back to
text-embedding-3-small. Now onlytext-embedding-3-smallandtext-embedding-3-largeare accepted; other values (e.g.text-embedding-ada-002) produce a clear error. SetEPISTEME_OPENAI_EMBED_MODELto a supported model name. - CLI:
explorerenamed tosearch(old name works as deprecated alias) - CLI:
mcpandapinow own their full service lifecycle (start,stop,restart,status,enable [--now],disable [--now]) - CLI:
servicetop-level command deprecated — usemcp start/stop/restart/status/enable/disableinstead - CLI:
mcp --httpdeprecated — usemcp startfor HTTP daemon mode - CLI:
launchd-install/uninstall/statusdeprecated — usemcp enable/disable/statusinstead enable/disablenow 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.1or0.0.0.0) with optionalepis-prefixed bearer tokens -
New
mcp.tokenconfig field andEPISTEME_MCP_TOKENenvironment 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
Authorizationheaders and to shell RC files asEPISTEME_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 installcopies 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 installupdates transport when config differs (stdio ↔ HTTP) -
MCP yaml config —
mcp.host/mcp.portinconfig.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 | shInstall 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/epistemeDownload 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 |
v0.3.2
Install episteme 0.3.2
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.2/episteme-installer.sh | shInstall prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.2
| File | Platform | Checksum |
|---|---|---|
| episteme-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| episteme-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
v0.3.1
Install episteme 0.3.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.1/episteme-installer.sh | shInstall prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.1
| File | Platform | Checksum |
|---|---|---|
| episteme-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| episteme-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
v0.3.0
Install episteme 0.3.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.3.0/episteme-installer.sh | shInstall prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.3.0
| File | Platform | Checksum |
|---|---|---|
| episteme-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| episteme-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
v0.2.4
Install episteme 0.2.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/epicsagas/Episteme/releases/download/v0.2.4/episteme-installer.sh | shInstall prebuilt binaries via Homebrew
brew install epicsagas/tap/epistemeDownload episteme 0.2.4
| File | Platform | Checksum |
|---|---|---|
| episteme-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| episteme-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |