Singularity documentation
Operate a persistent digital being.
Start with the runtime model, then follow the contracts for identity, mind, finance, skills, child beings, operations, and qualification.
Architecture
Singularity's design premise is that the model process is the least trusted
ReferenceThe being
Retain identity, mind and actions across launches without silently dropping older records.
ReferenceBootstrap
Verify a signed launch and acquire separate signing, authorization and Most credentials.
ReferenceCLI reference
Runtime, memory import, onboarding and durable ecosystem commands.
ConceptsBeing
Separate persistent being state from the process and credentials that currently animate it.
ConceptsChild
Spawn a separate being with declared accounting and workload credentials.
ConceptsEarning and cost record
Every model call is debited at its catalog price; no tool output credits the budget.
ConceptsIdentity
Preserve a being across renewed launch credentials without changing who it is.
ConceptsLease
The signed finance policy says what may ever move; who says money may move
ConceptsMind and memory stores
Persist the complete mind and make every retained memory available to cognition and recall.
ConceptsRule
Persist self-imposed rules without confusing them with enforced authority.
ConceptsSkill
Where does a being's ability to act on the world come from? Not from its own
ConceptsSolvency
The runtime has exactly one unconditional stop: a remaining balance that is not positive.
ReferenceConfiguration
Declare identity, accounting and service inputs; preserve the actual consumer's limits and refusals.
ReferenceQualification programs
Run repository-owned journeys against real dependencies and inspect their retained outcomes.
ReferenceThe finance boundary
Money is the one place where "the model decided" is never sufficient. The
ReferenceThe loop and solvency
Run model rounds until a plain reply or exhausted budget, accounting for every completion and tool outcome.
ReferenceQuick start
How do you go from a checkout to one completed autonomous cycle? This page is
ReferenceRepo surface
Claim one canonical main checkout, retain exact commit evidence, and publish without force.
ReferenceRunbook
Interpret runtime, finance and canonical repository refusals without discarding evidence.
ReferenceSkills via Las
Singularity ships almost no world-facing tools of its own. The dynamic
WalkthroughsWalkthrough: one transaction through the finance boundary
Can the whole money path — propose, simulate, approve, timelock, sign,
WalkthroughsManaged bootstrap and resume qualification
Exercise real runtime initialization and persisted identity renewal with signed Las and declared credentials.
WalkthroughsInspecting the state stores
Read being, ecosystem, finance and repository evidence without confusing recorded state with a live result.
ReferenceWhat is Singularity
Singularity is a native Rust runtime for one persistent autonomous digital
ReferenceSingularity benchmark
Versioned model evaluation, isolation, graders, verdicts, and canonical JSON outputs.
GuidesImport existing memory and knowledge
Bring attributed memory, knowledge, and profile records into a being without replacing its identity or activating financial authority.
RuntimeAutonomous ecosystem
Durable observations, independently reviewed opportunities, execution through Jeden, delivery through Stado and measured outcomes.
CLI commandssingularity ecosystem
Run the durable portfolio owner, or read and control a running one.
CLI commandssingularity ecosystem run
Own persistent portfolio state under one fixed delegated policy.
CLI commandssingularity ecosystem status
Read the live owner, admission, counts, spend and operation issues.
CLI commandssingularity ecosystem opportunities
List recorded opportunities, newest first.
CLI commandssingularity ecosystem initiatives
List initiatives and their state, newest first.
CLI commandssingularity ecosystem records
List retained record summaries without their bodies.
CLI commandssingularity ecosystem record
Read one retained record whole, or in revision-bound UTF-8 fragments.
CLI commandssingularity ecosystem explain
Read one initiative with its opportunity, review and related-record counts.
CLI commandssingularity ecosystem pause
Stop new admission without cancelling dispatched work.
CLI commandssingularity ecosystem resume
Reopen admission under the existing authority and allocation.
CLI commandssingularity run
Run autonomous cycles continuously while the being remains solvent.
CLI commandssingularity once
Execute exactly one autonomous cycle and print its persisted report.
CLI commandssingularity doctor
Preflight Brama, optional Most, Las, and every required tool surface without starting a cycle.
CLI commandssingularity tools
Print the dynamic Las and built-in tool catalogue as JSON or a tab-separated table.
CLI commandssingularity import
Atomically import attributed memory, knowledge, and profile records into an existing being.
CLI commandssingularity onboarding
Show or replay first use, optionally importing an existing mind before the walkthrough.
CLI commandssingularity ticket
Write the keys and the signed launch ticket singularity-bootstrap starts a managed being from, or start one end to end.
CLI commandssingularity activity
Read a being's activity journal, every event oldest first, without changing its state.