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
One being is one owner-only state directory. This page is the model of what
ReferenceBootstrap
`singularity-bootstrap` is how a managed deployment starts a being without
ReferenceCLI reference
The `singularity` binary has four subcommands. Every option is also an
ConceptsBeing
What survives when the process dies? The being: one owner-only state
ConceptsChild
A being that decides one existence is not enough calls
ConceptsEarning and cost record
Every model call costs money and almost nothing earns it — so the accounting
ConceptsIdentity
Who is this being, and under which exact code and policy does it run?
ConceptsLease
The signed finance policy says what may ever move; who says money may move
ConceptsMind and memory stores
How does a self-change today reach the model tomorrow? Through the mind:
ConceptsRule
Nobody hands this being a policy for its own behavior — it writes one, one
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, and it is not a task being
ReferenceConfiguration
Everything is configured through environment variables; each also exists as
ReferenceExamples
Runnable scripts behind the executed walkthroughs. All of them are
ReferenceThe finance boundary
Money is the one place where "the model decided" is never sufficient. The
ReferenceThe loop and solvency
The being lives cycle by cycle. A cycle is one user-visible unit of
ReferenceQuick start
How do you go from a checkout to one completed autonomous cycle? This page is
ReferenceRepo surface
`singularity-repo-mcp` is a stdio MCP server for policy-bound repository
ReferenceRunbook
Something refused, aborted, or went quiet — which sentence did it print, and
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,
WalkthroughsWalkthrough: bootstrapping a being in a sandbox
How far does a being get on a machine with no Brama gateway, no Las
WalkthroughsWalkthrough: inspecting the state stores
Singularity's honesty lives on disk: a being, a finance surface, and a repo
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.
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.