{"slug": "show-hn-kival-a-self-hosted-knowledge-system-for-organizations", "title": "Show HN: Kival – A self-hosted knowledge system for organizations", "summary": "Selemis released Kival, a self-hosted collaborative knowledge system that gives people and AI agents a shared place to create, edit, discuss, connect, version, and govern organizational knowledge. Kival is installed via the kivalup script from the latest stable release, runs against PostgreSQL 18, and is served at http://localhost:3000, with prebuilt releases for Linux x86_64 and ARM64, macOS on Apple Silicon, and Windows through WSL; native Windows and Intel Mac releases are not currently provided. The system is designed to preserve history, relationships, discussions, authorship, and provenance so knowledge stays understandable as people, agents, models, applications, and tools change.", "body_md": "Self-hosted collaborative knowledge system for organizations\n\n[Overview](#overview) ·\n  [Setup](#setup) ·\n  [Resources](#resources) ·\n  [SDKs](#sdks) ·\n  [Community](#community) ·\n  [Contributing](#contributing)\n\nKival is Selemis's self-hosted collaborative knowledge system for organizations.\n\nOrganizations constantly produce messages, documents, decisions, and records, yet the understanding that connects them is easily lost. Sources become detached from conclusions, decisions outlive their reasoning, and knowledge fragments across tools or leaves with the people who carried it.\n\nKival gives people and agents a shared place to deliberately create, edit, discuss, connect, version, and govern knowledge. History, relationships, discussions, authorship, and provenance remain connected as that knowledge develops, preserving the context needed to understand how something came to be and build on it over time.\n\n- **Shared knowledge** : people and agents work against the same organizational knowledge rather than maintaining separate copies of context.\n- **Continuity** : history, relationships, discussions, and provenance remain connected as knowledge develops, preserving how it came to be rather than only its latest state.\n- **Deliberate authorship** : knowledge is explicitly created and maintained as organizational work, with clear authorship, access, and governance.\n- **Durable context** : knowledge remains understandable even as the people, agents, models, applications, and tools around it change.\n- **Self-hosted ownership** : the organization retains control over the knowledge and infrastructure on which its work depends.\n\nInstall `kivalup` from the latest stable release:\n\n```\ncurl --proto '=https' --tlsv1.2 -fsSL \\\n  https://github.com/selemis-com/kival/releases/latest/download/install | bash\n```\n\nThen run:\n\n```\nkivalup\n```\n\nIf your shell has not picked up the updated `PATH` yet, use `$HOME/.kival/bin/kivalup` or start a new shell.\n\nTo build and run Kival from source, see the [development setup](https://github.com/selemis-com/kival/blob/master/CONTRIBUTING.md#development-setup).\n\nPrebuilt releases are available for Linux x86_64 and ARM64, macOS on Apple Silicon, and Windows through WSL.\n\nNative Windows and Intel Mac releases are not currently provided.\n\nStart PostgreSQL in the background with persistent local storage:\n\n```\ndocker run -d \\\n  --name kival-postgres \\\n  -e POSTGRES_USER=kival \\\n  -e POSTGRES_PASSWORD=kival \\\n  -e POSTGRES_DB=kival \\\n  -p 5432:5432 \\\n  -v kival-postgres-data:/var/lib/postgresql \\\n  postgres:18\n```\n\nPoint Kival at the database and start the server:\n\n```\nexport DATABASE_URL=postgres://kival:kival@localhost:5432/kival\nkivald serve\n```\n\nIn another terminal, bootstrap the first global administrator:\n\n```\nexport DATABASE_URL=postgres://kival:kival@localhost:5432/kival\nkivald admin bootstrap \\\n  --username admin \\\n  --display-name \"Admin\"\n```\n\nThe command prints a one-time enrollment link. Open it in your browser to register a passkey and complete the initial administrator setup.\n\nKival is now available at [`http://localhost:3000`](http://localhost:3000).\n\nCreate a workspace from the web application, or explore Kival using the built-in fictional ACME workspace:\n\n```\nkivald admin workspaces create --name \"ACME\" --demo acme\n```\n\nThe demo includes connected documents, discussions, access boundaries, history, and shared agent skills for exploring Kival before adding your own knowledge.\n\nImportant\n\nThe ACME workspace is intended for exploration and evaluation only. Do not use it as the basis for a production workspace or build real organizational knowledge on top of it.\n\nFrom the web application, [create an API key](http://localhost:3000/settings/api-keys) for the administrator and allow it access to the workspace.\n\nThen configure the local CLI:\n\n```\nexport KIVAL_API_KEY=<API_KEY>\n```\n\nVerify the CLI is authenticated and can access the workspace:\n\n```\nkival whoami\nkival workspaces list\n```\n\nAgents can use the same CLI and access model to inspect existing knowledge, follow relationships, and contribute new material.\n\n**Trace a decision and its supporting context**\n\nUse the Kival CLI to explore the ACME workspace. Find an important decision, explain what was decided and why, trace the supporting knowledge that led to it, and include links to the relevant Kival objects.\n\n**Synthesize project state into new knowledge**\n\nUse the Kival CLI to inspect Project Relay and RFC 024. Create a new object titled \"Project Relay rollout review\" summarizing the current rollout state, remaining risks, and next decision point, then link it to the relevant existing Kival objects. Show me what you created and include links to the objects you used.\n\n**Turn operational history into follow-up knowledge**\n\nUse the Kival CLI to find a recent ACME incident and its related runbook. Create a short follow-up object with the key operational lesson and recommended next action, link it to both the incident and runbook, and include links to the resulting Kival objects.\n\nThe [Kival resources](https://selemis.com/resources) cover how Kival works, how to use it, how to connect it to other systems, and how to run it in production.\n\nKival provides official SDKs for Rust and TypeScript:\n\nBoth use scoped API keys and expose the same underlying system as the CLI.\n\nThey are intended for applications, integrations, automation, and agents that need programmatic access to Kival.\n\nKival is developed and maintained by [Selemis](https://selemis.com).\n\nSponsorship supports the continued development and long-term maintenance of Kival. Organizations interested in sponsoring the project can contact [hello@selemis.com](mailto:hello@selemis.com).\n\nJoin the conversation in [GitHub Discussions](https://github.com/selemis-com/kival/discussions) to ask questions, share ideas, and discuss how Kival is being used.\n\nSee the [Contributing Guide](https://github.com/selemis-com/kival/blob/master/CONTRIBUTING.md) for information on reporting bugs, proposing features, and contributing to Kival.\n\nAt this time, we do **not accept pull requests or other code contributions from external contributors**.\n\nIf you believe you have found a security vulnerability, please do not report it through GitHub Issues.\n\nSee the [Security Policy](https://github.com/selemis-com/kival/blob/master/SECURITY.md) for reporting instructions.\n\nLicensed under either of [Apache License, Version 2.0](https://github.com/selemis-com/kival/blob/master/LICENSE-APACHE) or [MIT license](https://github.com/selemis-com/kival/blob/master/LICENSE-MIT) at your option.\n\nThis software includes third-party components subject to separate license terms. See [THIRD_PARTY_NOTICES.md](https://github.com/selemis-com/kival/blob/master/THIRD_PARTY_NOTICES.md).\n\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.", "url": "https://wpnews.pro/news/show-hn-kival-a-self-hosted-knowledge-system-for-organizations", "canonical_source": "https://github.com/selemis-com/kival", "published_at": "2026-09-16 09:48:32+00:00", "updated_at": "2026-09-16 10:13:45.432452+00:00", "lang": "en", "topics": ["ai-agents", "ai-products", "ai-tools"], "entities": ["Selemis", "Kival", "kivalup", "PostgreSQL 18", "kivald", "ACME", "Linux", "macOS"], "alternates": {"html": "https://wpnews.pro/news/show-hn-kival-a-self-hosted-knowledge-system-for-organizations", "markdown": "https://wpnews.pro/news/show-hn-kival-a-self-hosted-knowledge-system-for-organizations.md", "text": "https://wpnews.pro/news/show-hn-kival-a-self-hosted-knowledge-system-for-organizations.txt", "jsonld": "https://wpnews.pro/news/show-hn-kival-a-self-hosted-knowledge-system-for-organizations.jsonld"}}