Skip to content

v0.2.0 — Onboarding friction reduction

Choose a tag to compare

View all tags
@Kvendra Kvendra released this 27 May 09:57
· 2 commits to main since this release
v0.2.0
710b339

Summary

First tagged release of the Kvendra reference-stack. Reduces onboarding friction for self-hosted users by aligning with Claude Code as universal orchestrator (PAT-KVD-4AF89B) and making Ollama opt-in.

What changed

Vector A — Cleanup cline + Claude Code alignment

  • docker-compose.yml: header comments reflect Claude Code as universal orchestrator (no cline).
  • README.md: 5 sections rewritten — header, quick start, what's NOT in stack, modes heading, contributing. Zero productive cline / npx skills refs.
  • docs/troubleshooting.md: cline_mcp_settings.json snippet replaced by claude mcp add block.
  • docs/tier-a-b-c.md renamed to docs/modes.md and rewritten as a 3-modes table (Cloud default / Ollama opt-in / Mock CI).
  • docs/lab-notes-free-tier-2026-05-22.md: preservation note header (historical content preserved verbatim).
  • LICENSE: URL drift github.com/KvendraAI/skills → KvendraAI/kvendra-skills fixed.

Vector B — Default cloud embeddings + Ollama opt-in profile

  • docker-compose.yml: EMBEDDINGS_PROVIDER default = openai-compatible pointing to https://api.kvendra.cloud/v1 with EMBEDDINGS_API_KEY=REPLACE_WITH_YOUR_KVENDRA_KEY placeholder.
  • docker-compose.yml: kvendra-ollama service gated by profiles: [ollama]. Default docker compose up starts 3 containers (db + platform + backup, no Ollama, no 5 GB pull). docker compose --profile ollama up adds Ollama.
  • .env.example: rewritten with cloud-default + 2 commented alternative blocks (Ollama local / mock CI). BACKUP_CRON quoted to fix bash 3.2 source. Drift api.kvendra.com → api.kvendra.cloud corrected.
  • scripts/up.sh: new --with-ollama / --help flags. Post-up banner detects API key placeholder and prints signup instructions + Ollama alternative.
  • scripts/smoke-cloud.sh (NEW, chmod 0755): wire-validate against api.kvendra.cloud/v1/embeddings. Exit 3 on placeholder, verifies dim=1024 response.

Outcome

Minimum self-hosted flow:

  1. git clone + cp .env.example .env.
  2. Sign up at https://kvendra.cloud → grab free-tier API key (200k tok/month).
  3. Paste key in .env.
  4. ./scripts/up.sh.
  5. Install Claude Code + claude mcp add kvendra-platform http://localhost:7777/mcp -H "Authorization: Bearer <token>".
  6. claude plugins install kvendra-skills.

Prefer no signup? ./scripts/up.sh --with-ollama (5 GB models, fully local).

Breaking changes

None. Users with an existing .env (e.g. EMBEDDINGS_PROVIDER=mock) keep their setting — defaults only apply to fresh .env copies from .env.example.

Stats

  • 10 files changed, +410 / −209.
  • 1 rename (tier-a-b-c.md → modes.md).
  • 1 new file (scripts/smoke-cloud.sh).
  • Closes ISSUE-KVD-REFERENCESTACK-35D1DE (cline cleanup) and ISSUE-KVD-WEB-DB033A (/install page update).
  • Materializes PAT-KVD-4AF89B (single skill set, Claude Code as universal orchestrator).
Assets 2
Loading