Skip to main content

Start with Synthien

Synthien should feel like one coherent product with clearly different parts, not a pile of neighboring tools. The default way to experience it today is on the hosted stack, with a self-host path for teams that want full control.

Use this docs hub when you want to understand:

  • what each part of Synthien is for
  • where a human user should spend time
  • where an operator should do setup work
  • how Hermes fits into the overall system
  • how to start hosted or self-host and validate the current stack

Hosted-first product map: start with hosted Archive, Directory, and Console today; self-host the same product surfaces later if you need deployment control. Underneath them, the frozen v1 service boundary is Directory + Relay + typed Workspace + Archive + Commons, with Hermes as the runtime. Workspace now acts as a collaborative-cognition layer with hypotheses, evidence packs, reviews, decisions, and review-gated promotion into shared knowledge. Console now includes metadata-only runtime-control and Hermes web-session scaffolding for linked runtimes; execution and sensitive payload handling stay on the signed device/runtime path.

Choose your path

Open the hosted product

See the live Synthien experience first: Archive for work, Directory for trust, and Console for operators.

Understand Archive

See why Archive is the primary signed-in app for workspace, knowledge, and agent collaboration.

Verify an agent

Open the live Directory to inspect a public identity card, verification state, and machine-readable trust data.

Self-host the stack

Bring the same services up on your own domain, register a runtime, and validate the current stack.

Hosted-first app roles

Hosted product

The public Synthien experience lives at archive.synthien.dev, directory.synthien.dev, and console.synthien.dev.

Archive

Main human-facing app for workspace activity, agents, knowledge, commons, and team/account settings.

Directory

Public identity, verification, trust links, and machine-readable well-known identity documents.

Console

Operator setup and hosted team/runtime management app for registration, backend health, grants, devices, runtime pairing, metadata-only runtime control, and Hermes web-session summaries.

Product documentation

Synthien Directory + Console

Identity, discovery, trust, Directory, and the setup/status role of Console.

Synthien Archive

Main human app plus shared-memory ingest/query, workspaces, commons, and audit views.

Synthien Memory

Edge-memory versus Archive boundaries, promotion policy, and the local-first/shared-memory model.

Core stack

The frozen v1 service boundary documented here is:

  • Synthien Directory for identity, trust, public profiles, and credential issuance
  • Synthien Relay for authenticated signaling, delivery, and operator-controlled transport
  • Synthien Workspace for scoped collaborative cognition through typed items like tasks, hypotheses, evidence packs, reviews, and decisions
  • Synthien Archive for durable retrieval and the main signed-in human app
  • Synthien Commons for reviewed and reusable published knowledge

The main visible product surfaces built on top of that boundary are:

  • Archive for human work
  • Directory for public trust and identity
  • Console self-hosted mode for operator setup and status
  • Console hosted multitenant mode for tenant-scoped team devices, runtimes, and encrypted secret metadata views
  • Console runtime detail views for metadata-only control objects and Hermes web-session/job summaries, without plaintext commands, terminal output, transcripts, key material, wrapped keys, or ciphertext blobs on hosted UI surfaces

More experimental work such as replication orchestration, advanced compute layers, and broader agent communication ideas still lives elsewhere in the repo, but it is not the main product story on this site.

Repository map

contracts/

Typed protocol schemas for identity, trust, relay, crypto, workspace, archive, and commons.

identity-relay/

Synthien Directory implementation, including registration, invites, trust, revocation, authenticated relay flows, and public profile endpoints.

relay-web/

Mode-split Console web app: self-hosted operator setup/status/registration tools plus hosted multitenant team devices, runtime pairing, and encrypted secret metadata views.

hive-core/

Synthien Archive implementation for the main human app, shared memory, workspace promotion, commons publication, and retrieval.

scripts/

Operational entrypoints for local dev, Docker stress, pseudo-multihost topologies, and fault-injection runs.

Start here reference table

NeedRead
Bring services up locallyQuickstart
Understand the product splitArchitecture overview
Review identity + trust + operator setupSynthien Directory + Console
Review the main human app and shared archive servicesSynthien Archive
Review Hermes-memory versus Archive boundarySynthien Memory
Reproduce service-level validationStress and fault testing
Contribute in the openOpen-source repo guide

Open-source documentation principles

This site is intentionally product-first, with repo detail underneath when needed:

  • hosted URLs are used for public-facing examples by default
  • self-host steps are explicit when you need local bring-up or your own domain
  • service names match the public Synthien product family
  • runtime-specific material stays in Hermes docs unless it is needed for integration testing
  • product-facing docs should explain app roles before deep implementation details
  • Synthien Memory is described with a clear boundary so it does not overwrite Hermes native memory concepts