Skip to content

RAGLens v0.4.0 — Local Release / Install & First-Run Experience

Choose a tag to compare

View all tags
@Schromeo Schromeo released this 15 Jul 05:26
· 14 commits to main since this release
v0.4.0
f372087

Project renamed: RAGLens is now SledTrace.

See the v0.4.1 release for the current project name and migration details.

RAGLens v0.4.0 — Local Release / Install & First-Run Experience

RAGLens v0.4.0 packages the project as a cleaner local-first release candidate for external developers.

This release focuses on first-run developer experience: Docker-based local startup, explicit configuration, health checks, reference demo validation, local reset guidance, release notes, and improved documentation.

Highlights

  • Added Docker Compose local stack for the Go collector and React dashboard.
  • Added Dockerfiles for the collector and dashboard.
  • Added .env.example for local configuration defaults.
  • Added .dockerignore to keep Docker build context clean.
  • Added MIT license.
  • Added v0.4.0 release notes.
  • Added reference RAG app runbook.
  • Added optional health-check script.
  • Updated README with Docker-first quickstart and fallback local startup path.
  • Updated smoke-test and maintainer handoff docs.
  • Preserved existing Python SDK trace contract.
  • Preserved deterministic-first warning generation.
  • No changes to collector API, storage schema, dashboard data contract, or warning rule behavior.

Validation

Validated with the following commands:

cd collector/go
go test ./... -count=1

cd dashboard/web
npm run build

cd ../..
docker compose up --build

curl http://localhost:4319/health
curl http://localhost:5173

cd sdk/python
pip install -e .
python -m examples.reference_rag_app.run all

All expected reference traces were generated:

  • reference-rag-app-refund
  • reference-rag-app-conflict
  • reference-rag-app-wrong-window
  • reference-rag-app-processing-range
  • reference-rag-app-wrong-processing-range
  • reference-rag-app-damaged
  • reference-rag-app-digital
  • reference-rag-app-subscription
  • reference-rag-app-weak

Current Implemented Span Types

  • retrieval
  • llm

Current Warning Rules

  • no_retrieved_chunks
  • low_retrieval_score
  • duplicate_chunks
  • weak_query_chunk_overlap
  • numeric_mismatch
  • conflicting_chunks
  • answer_not_grounded

Not Included in This Release

  • PyPI publishing
  • LangChain adapter
  • LlamaIndex adapter
  • hosted collector
  • auth
  • cloud sync
  • agent/tool/memory spans
  • LLM-as-judge default evaluator

Recommended Quickstart

From repo root:

docker compose up --build

Then in another terminal:

cd sdk/python
pip install -e .
python -m examples.reference_rag_app.run all

Open:

http://localhost:5173
Assets 2
Loading