Semiont is an open, source-grounded semantic knowledge platform for building and maintaining trusted AI knowledge bases and context layers. It gives humans and AI agents a shared workspace and architecture to annotate, connect, enrich, and govern domain knowledge for accurate applications, agents, and workflows.
Install one of Apple Container, Docker, or Podman if you don't already have one.
Run the published browser container image (substitute docker or podman for container as needed):
container run --publish 3000:3000 -it ghcr.io/the-ai-alliance/semiont-frontend:latestThen open http://localhost:3000 in your web browser.
For local-network access notes, supply-chain verification, the native desktop app alternative, and frontend dev setup, see docs/browser/.
Clone a knowledge base and follow its README. Each KB repo contains configuration, container definitions, and startup scripts under .semiont/.
| Template | Description |
|---|---|
| semiont-template-kb | Empty template — start here for a new project |
These ship a small corpus and a layered set of skills (ingest → mark → canonicalize → wire-edges → compose-aggregates) that demonstrate the SDK in a particular domain. The value is the skills, not the data — the skills are corpus-generic and work on any corpus dropped into the same directory layout.
| Knowledge Base | Domain |
|---|---|
| semiont-gutenberg-kb | Public-domain literature from Project Gutenberg |
| semiont-arxiv-kb | Research papers from arXiv |
| semiont-legal-kb | Synthetic legal documents — contracts, attorney correspondence, internal memos |
| semiont-caselaw-kb | U.S. case law — Supreme Court opinions and state appellate cases |
| semiont-clinical-evidence-kb | Synthetic clinical evidence — trials, observational studies, treatment guidelines, drug-safety reports |
| semiont-newsroom-kb | Synthetic investigative-journalism documents — interview transcripts, FOIA responses, public statements |
| semiont-household-kb | Synthetic home-property records — service receipts, contractor emails, manuals, mortgage / insurance, HOA notices |
| Knowledge Base | Domain |
|---|---|
| synthetic-family | Synthetic family history and genealogy |
In the Semiont browser's Knowledge Bases panel, enter host localhost, port 4000, and the email and password you provided when starting the backend.
Every operation in the GUI is available programmatically through three surfaces:
- Semiont SDK — type-safe TypeScript client (
@semiont/sdk) for scripts, embeddings, and apps. - Semiont CLI — drive Semiont from the terminal.
- Agent Skills — ready-made skill definitions for agentic coding assistants like Claude Code.
All three are organized around eight composable flows — frame, yield, mark, match, bind, gather, browse, beckon — the same verbs whether driven by a human, a script, or an AI agent. See docs/protocol/ for the protocol overview, design tenets, and value proposition.
⚠️ Alpha. API and package surface are not yet stable; breaking changes between 0.x releases are expected.
- Development docs — codebase layout, build status badges, Codespaces shortcut, where to read next.
- System architecture — actor model, knowledge system, container topology, package architecture.
- CONTRIBUTING.md — branch/PR workflow, commit conventions, platform-contribution playbook.
Apache 2.0 - See LICENSE for details.