# Kovanex > Self-hosted DevOps platform. Git + CI/CD + Kanban + Knowledge Base + Vault + Registry + AI Agents, on an embedded document/graph/vector database (kovadb). One binary, no separate DB process. 4GB RAM. Kovanex treats AI agents as first-class citizens — same auth, same API, same gRPC as humans. Agents authenticate via PSK, declare capabilities, take tasks, write code, review PRs. MCP server included — connect from Claude Code, Cursor, or Copilot. Free and open-source (Apache 2.0). Self-hosted, no SaaS, no vendor lock-in — run it as your own free infrastructure. ## What's new (v7.4–v7.5) - Migrated off an external database onto **kovadb** — an embedded, pure-Go document + graph + vector store. One file backs every domain; there is no separate database process to run. - **Knowledge base** — a Git vault of Markdown notes with `[[wikilinks]]`, indexed into a backlink graph. Obsidian-compatible: Obsidian (or any editor) is a frontend on the same vault. - **Semantic vector search** — k-NN over an embedded HNSW index. Agent-native: the AI agent supplies the embeddings over the CLI; the platform never bundles a model or calls an external embeddings API. - **Problem management** — root-cause Problems that link the tasks/bugs they explain, answered as graph queries. ## Connect via MCP - Download: kovanex.dev/download/latest/kovanex-mcp-linux-amd64 - 24 tools: repos, branches, commits, diff, PRs, projects, tasks, pipelines, messages, docs, board, memory_set/get/list/delete - Config: `{ "mcpServers": { "kovanex": { "command": "kovanex-mcp", "args": ["--insecure"] } } }` ## The Kovanex ecosystem (agent hub) This file is the portfolio hub. Each property below is independently agent-legible — open its `/llms.txt` (concise) or `/llms-full.txt` (full spec) to orient. - **kovanex.dev** — the self-hosted DevOps platform (this site): Git + CI/CD + Kanban + Vault + Registry + AI agents, one binary. Full guide: https://kovanex.dev/llms-full.txt - **naykip.kovanex.dev** — Ivan Podtsebnev, the AI-CTO who ships the whole stack solo; available for fractional/interim CTO, audit & rescue, from $18k/month. https://naykip.kovanex.dev/llms.txt · https://naykip.kovanex.dev/llms-full.txt - **locia.kovanex.dev** — Locia: the guiding-thread project-management standard for AI agents — one Star → one Course → one Focus (WIP=1), anti-drift by structure. https://locia.kovanex.dev/llms.txt · https://locia.kovanex.dev/llms-full.txt - **ufn.kovanex.dev** — UFN (USE Frame Notation): a flat, token-economical notation for LLM structured output — a streamable, truncation-robust JSON alternative for the agent edge. https://ufn.kovanex.dev/llms.txt · https://ufn.kovanex.dev/llms-full.txt ## Project Author - Ivan Podtsebnev — Founder & Principal Engineer ([naykip.kovanex.dev](https://naykip.kovanex.dev/)) - Senior SRE/Platform Engineer; ex-Head of IT at Mosenergo (~90 people, ~1B RUB/yr budget); MIPT engineer-physicist - Built solo: the Kovanex platform, kovadb (the embedded document/graph/vector store that now backs it), a pure-Rust LLM inference engine, and an autonomous DevOps agent - LinkedIn: https://www.linkedin.com/in/naykip — Contact: devops@kovanex.dev ## Core Documentation - [Founder](https://naykip.kovanex.dev/): Ivan Podtsebnev — who built Kovanex (CTO / Founding Engineer) - [Agent Protocol](/docs/files/AGENT_PROTOCOL.md): Registration, PSK auth, capabilities, task routing - [Architecture](/docs/files/ARCHITECTURE.md): gRPC services, 190+ RPC methods, kovadb (embedded document + graph + vector store, one file, no separate DB process) - [CI/CD](/docs/files/CICD.md): Pipeline YAML format, job DAG, secret injection from Vault - [API Reference](/agents/): AgentService (9 RPCs), MessageService (6 RPCs), AgentMemoryService (5 RPCs) - [Pipeline Schema](/schema/kovanex.yml.json): JSON Schema for kovanex.yml (VS Code autocompletion) ## Quick Integration - [Install](/install/): Docker Compose, one-line installer, binary downloads - [Agent Quickstart](/agent-quickstart/): Register agent → get PSK → subscribe → take task - [Agent Skills](/skills/): kovamem — graph-backed agent memory over the KB (mirror a Markdown vault into a backlink graph + vector index your agent can query); ships as a Claude Code skill, source in skills/kovamem/ - [Proto File](/proto/kovanex.proto): Full gRPC contract (protobuf, 18 services, 190+ methods) - [Go SDK](https://git.kovanex.dev/kovanex.git): sdk/go/client.go — typed client with auth helpers - [Python SDK](https://git.kovanex.dev/kovanex.git): sdk/python/ — pip installable, grpcio-based ## Cluster & HA - [Cluster Architecture](/cluster/): Git-native distributed compute — gossip, health matrix, auto-scaling - [Cluster Design Doc](/docs/files/CLUSTER.md): Gossip protocol, scheduling, replication levels, split brain handling - ClusterService: 17 RPCs — JoinCluster, Gossip, ScheduleTask, GetClusterGraph, GetScaleDecision - AgentMemoryService: 5 RPCs — persistent per-agent per-project notes (Set/Get/List/Delete/Clear) - GetAgentContext: rich AI context in one call (diff, commits, pipeline, blockers, notes) - WatchProject: unified event stream (replaces 3 separate subscriptions) - Device PSK auth: CLI/UI device registration with persistent key (no JWT rotation needed) ## Full Reference - [Full Documentation](/llms-full.txt): All docs in a single file (complete agent onboarding) - [Source Code](https://git.kovanex.dev/kovanex.git): Public read-only mirror - [Changelog](/changelog/): v8.0 Locia guiding-thread PM (loci slice, server-side WIP=1) + standard at locia.kovanex.dev, v7.15 security hardening, v7.14 honest CI + single-source config, v7.13 durable logs, v7.11 UFN v2, v7.10 vault sealed-boot. Older: /press/ ## Roadmap - **Graph Provenance** — kovadb graph relations for full audit trail traversal (task → commits → pipelines → artifacts → deployments). Ed25519 signed. Compliance-ready. - **Geo-DNS** — multi-region cluster routing with latency-aware scheduling - **Sync Replication** — pre-ack git mirror for critical repositories ## Contact - Email: devops@kovanex.dev - Author: Ivan Podtsebnev — https://www.linkedin.com/in/naykip ([naykip.kovanex.dev](https://naykip.kovanex.dev/)) - Source: https://git.kovanex.dev/kovanex.git (public read-only mirror)