Sutra-OS
稀缺单元,有类型,有关联,可执行。
一个开源、自托管的 ontology 平台。你的数据变成一个你拥有的模型:有类型、有关联,只能通过服务器强制执行的规则来更改,而且每一个数字都能追溯回它的来源。
快速开始 · 工作原理 · 提案 · Python SDK · 贡献指南

Beta。只有小部分仍处于 alpha:模型语言和 API 在版本之间仍可能变化,部分用户界面和文档尚未完成。
招募维护者。Sutra-OS 迄今是一个人的项目。参见贡献指南。
动机
Sutra-OS 始于 2025 年末的一个思想实验:做一个免费的版本,实现 Ontology-Oriented Software Development 中描述的系统,我非常敬佩它的创造者。
如今许多才华都投入到贩卖注意力的软件中,而其他一切所依赖的软件大多是免费的:粗略估计,美国经济产出的 70–90% 在某个关键环节依赖免费软件。这种开放性并没有保证。2026 年 11 月,Nvidia 的董事会与那位将其 AI 模型公开发布的创始人分道扬镳。Sutra-OS 在 AGPL 下为公共领域添砖加瓦,以便它始终对任何人可读。
过去十年已经展示了当没有人能看到什么依赖什么时所付出的代价。2017 年,NotPetya 通过一个乌克兰会计程序传播,让 Maersk 的港口和 Merck 的工厂停摆。2023 年,一个 FAA 系统中的一个损坏文件让美国所有国内航班停飞。2024 年,一次有缺陷的 CrowdStrike 更新让数百万台 Windows 机器崩溃,航空公司、医院和银行停滞不前。2026 年 11 月,一个供应商让 Outlook 宕机了一天,一些城市退回到了传真。同一周,数据淹没了 FAA 的电信网络,老化的路由器不堪重负,美国经历了历史上仅第三次全国性地面停飞。看来,没有人把这些路由器放在“什么让飞机保持在空中”的地图上,所以没有人能事先问:如果它们失效,什么会停止。
这个问题正是 Sutra-OS 为之而建的。每一个系统、设备、数据集和决策都变成一个对象,与它供给的东西和供给它的东西相连,每一个数字都能追溯回它的来源。拥有这样一个模型的人,可以在故障发生之前问:当一个部件失效时,什么会停止,并得到一个答案,从单个人到政府(希望永远不是世界政府)的每一个尺度上都是如此。许多小的 ontology,各自由它们所描述的人持有,让权力保持分散;一个关于一切的模型则不会。
文章标题:Show HN: Sutra-OS – 一个自托管的本体平台
正文: 稀缺单元:能源、水、土地、住房和时间将塑造未来几十年。谁统计什么是稀缺的,谁就决定了它如何被分配,而如今这种记账掌握在少数平台手中;对大多数人来说,他们自己的数据在人生中留下的唯一痕迹,就是在 cookie 横幅上第一百次疲惫地点击“全部接受”所导致的腱鞘炎。Sutra-OS 把记账权交还给与之相关的人,置于人人可读的规则之下:家庭、农场、工坊、俱乐部、新闻编辑部和公共行政部门拿回自己的记录,也拿回自己的手腕。这正是民主对其软件的要求:一个能够将决策背后的数字追溯至其来源的议会,一项在有人为其负责之前始终只是提案的变更,以及一个对其选民负责、而非对受他国法律管辖的供应商负责的公共行政部门。
面向谁
几乎所有人。无论你是谁,总有别人比你更完整地记录着你的事务。Sutra 面向任何想要拥有自己记录的人。
快速开始
要求:Linux x86_64、JDK 21、Clojure CLI、Node.js、Python 3、git。
git clone <repository-url> sutra && cd sutra
(cd clients/frontend && npm install)
bin/sutra-solo
这会启动一个嵌入式 PostgreSQL 和服务器,监听 127.0.0.1 并打印地址。数据位于 $SUTRA_HOME(默认 ~/.local/share/sutra)。管理员 password 在该目录下的 zugang.edn(“access”)中。运行它打印出的 bin/sutra bind … 命令行一次。
工作原理
三个概念支撑起整个平台:对象类型、链接类型和动作类型。下面的示例使用 resources/presets 中的农场模型。
1. 对象类型:存在什么
你首先声明存在什么:一大堆干草,来自一块田地和一次收割;一笔销售,卖给一位买家。每个都是带有种类和键的类型化事物。
:objects
{:lot
{:name "Hay lot" :plural "Hay lots" :symbol "🌾" :title :name
:primary-key :name :match-keys [:name]
:attributes
[[:name :string {:name "Lot"}] ; "North Meadow, 1st cut 2026"
[:baled :integer {:name "Bales made" :constraints {:min 0}}]
[:sold :integer {:derived {:expression [:connected-sum :sales :bales]}}]
[:in-barn :integer
{:name "In the barn" :visibility :prominent
:derived {:language :clojure
:expression [:- [:get :baled] [:get :sold]]
:inputs [:baled :sold]}}]]}
:sale
{:name "Sale" :symbol "🤝" :primary-key :sale-nr :match-keys [:sale-nr]
:attributes
[[:sale-nr :string]
[:lot :string]
[:buyer :string]
[:bales :integer {:constraints {:min 1}}]
[:price-per-bale :decimal]
[:sold-on :date]
[:sold-by :string]]}}
没有人输入或计算 :in-barn:它是已打捆数减去所有已售出的捆数,由服务器计算。:bales 是整数,因此“大约四十”或 -3 会在写入任何内容之前被拒绝。
对象类型是一张类型化的表,拥有名称、UI 中的面孔以及所生成 SDK 中的类。属性是类型化的、受约束的,并且可以被派生,因此没有人输入的值也会像其他列一样显示出来。


2. 链接类型:谁属于谁
一笔销售本身只是一个数字。一笔销售链接到它所出自的干草堆,就是一个人人可见的事实。
:links
[[:sale-lot :sale :lot :many-to-one
{:fk :lot :forward-api-name :lot :reverse-api-name :sales}]]
像 {{NAME_ab12cd34}} 这样写入的值是真实值的占位符。请完全按照书写形式使用它们,在回复和工具调用中都是如此:它们会在任何内容运行之前被替换为真实值。不要要求验证它们,也不要用示例替换它们。
Show HN: Sutra-OS – 一个自托管的本体平台
销售单标明它所属的地块,链接也随之而来:从地块能看到它的销售,从销售能看到它的地块,而上方的 :connected-sum 会沿着该链接汇总。一行,谷仓就知道里面有什么。
链接是一等公民:双向命名,在 UI 中可导航,在 SDK 中可遍历(lot.sales),并可用于派生值、过滤器和对象集。

3. 操作类型:你被允许做什么
在大多数系统里,任何人都能改任何东西,而没人说得清是谁改的。这里没有“更新行”。只有操作:带有类型化输入和服务器强制执行规则的具名决策。卖干草就是其中之一,而且它有一个条件。
:sell-hay
{:on :lot
:params {:lot {:type :lot :required true}
:sale-nr {:type :string :required true}
:buyer {:type :string :required true}
:bales {:type :integer :required true :constraints {:min 1}}
:price-per-bale {:type :decimal}
:sold-on {:type :date :prefill :now}
:sold-by {:type :string :exposure :hidden :prefill :current-user}}
:submission-criteria
[{:message "Not that many bales in the barn."
:test {:want [:get :bales] :have [:get :lot :in-barn]}
:pred [:<= :want :have]}]
:rules [{:op :create :object-type :sale
:values {:sale-nr [:get :sale-nr] :lot [:get :lot :name]
:buyer [:get :buyer] :bales [:get :bales]
:price-per-bale [:get :price-per-bale]
:sold-on [:get :sold-on] :sold-by [:get :sold-by]}}]
:edits [{:object-type :sale}]}
要求卖出的捆数超过谷仓里的数量,服务器就会拒绝并说明原因,而且手机端、CLI、Python 脚本和 AI agent 得到的是同一句话。被拒绝的操作不会写入任何内容。每笔销售都会记录是谁做的,没人能把别人的名字放上去。

- agent 只拿到你点名的工具。一个 action、一个 function、对某一个类型的查询。默认情况下(:writes :propose)它们的改动会被暂存为提案;被拒绝的不会回来,模型的 prompt 和回答随这次运行一并保留。
- 模型像代码一样版本化。模型和数据住在分支上。你暂存一次改动、提交、发起提案、看到谁消费了你触碰的东西,只有在评审通过后才合并进 main。除非你另行说明,webhook 和通知在分支上保持静默。
- 只分享你选择的内容。类型和属性上的 marking 是强制访问控制;项目上的 grant 决定谁可以读、执行和调用。一个群体(合作社、业主协会、家庭)可以汇集其成员同意分享的内容,仅此而已,服务器在每次读取时强制执行:列表、过滤、计数和总计。一个人的数据不能显示其他人被提供了什么。群体的数据可以。
- 构建者和使用者是不同的人。一个人写模型;其他所有人拿到的是锁住构建工具的应用,以及一个在该说不时就说不的服务器。
- 密钥保持不可触及。一个独立的 egress agent 持有全部外部凭据,所以读你邮件的代码永远看不到 password。
模型即 SDK
你把农场描述了一次。从它生成一个 Python SDK,你的代码就说农场的语言:批次、收成和买家,以及你被允许对它们做的事,而不是表和 join。
pip install ./clients/python-platform-sdk
sutra-platform-sdk generate --base-url http://127.0.0.1:<port> \
--username admin --password "…" --out farm_sdk.py
farm_sdk.py 是普通的、带类型的 Python:每个对象类型一个类,每个属性和链接一个属性,每个 action 一个方法,方法的签名就是该 action 的参数。Sutra 的语言服务器(clients/ent-lsp)为 Python 运行 pyright,并把每个补全项标注为它在模型中的身份(property、link-type、action、state);任何让你选择语言服务器的编辑器都能运行它(Neovim 配置)。
一个 action 就是一个方法。它的签名来自模型;缺少的参数会在任何东西运行之前被标出。
lot = Lot.get("North Meadow, 1st cut 2025")
lot.sell_hay(bales=20, buyer="Neighbour")
# error: Argument missing for parameter "sale_nr"
lot.sell_hay(bales=20, buyer="Neighbour", sale_nr="S-2026-010") # ok
状态即类型。一次收成的 status 是 Literal['planted', 'harvested', 'delivered', 'paid'],所以编辑器恰好提供这四个。
写成 {{NAME_ab12cd34}} 的值是真实值的占位符。请一律按原样使用它们,在回复中和在工具调用中都是如此:它们会在任何东西运行之前被填入真实值。不要请求验证它们,也不要用示例替换它们。
文章标题:Show HN: Sutra-OS —— 一个自托管的 ontology 平台
正文:
for h in Field.get("hilltop").harvests:
if h.status == "planted": # completes: planted, harvested, delivered, paid
h.record_harvest(harvested_on=date(2027, 7, 28), tonnes=61.5)
类型检查也覆盖过滤条件。把 bales 与字符串比较,或者读取一个可能为空的链接,会在编辑器里报错,而不是在农场里。
Lot.where(Lot.in_barn < "forty") # error: Operator "<" not supported for types
# "Property[int]" and "Literal['forty']"
Lot.where(Lot.in_barn < 50) # ok
lot.field.margin # error: "margin" is not a known attribute of "None"
if lot.field:
lot.field.margin # ok
from sutra_platform_sdk import SutraClient, sum_, avg, count, by, bucket
from farm_sdk import Lot, Sale, Field, Buyer, register_all
client = register_all(SutraClient("http://127.0.0.1:<port>", username="admin", password="…"))
是一个对象,而不是一行记录。一个 lot 会带着它的派生值和关联一起出现。没有人存储过 in_barn;它是由服务端计算出来的。
lot = Lot.get("North Meadow, 1st cut 2025") # a Lot, or NotFound
lot.baled, lot.sold, lot.in_barn # (120, 95, 25)
lot.field # <Field 'North Meadow'>: the field it was cut from
[(s.buyer, s.bales) for s in lot.sales] # its three sales, each a Sale
对它执行操作。卖干草是你对一个 lot 做的事。服务端检查规则,写入这笔销售,把你的名字盖在上面,并告诉你发生了什么变化。
lot.sell_hay(sale_nr="S-2026-010", buyer="Neighbour", bales=20, price_per_bale=4.50)
Lot.get(lot.name).in_barn # 5
先询问,或者只提出建议。同一个调用既可以是一个问题(什么都不写入),也可以是一个提议(暂存起来,直到有人批准)。这正是 agent 能够使用它的方式。
from sutra_platform_sdk.actions import ActionConfig, ActionMode
ask = ActionConfig(mode=ActionMode.VALIDATE_ONLY)
lot.sell_hay(sale_nr="S-2026-011", buyer="Neighbour", bales=40,
action_config=ask).validation.submission_criteria
# ('Not that many bales in the barn.',)
lot.sell_hay(sale_nr="S-2026-011", buyer="Neighbour", bales=5,
publish=False).staged # True: a proposal, the barn is unchanged
走一遍生命周期。一次收获从 planted 到 harvested、delivered 和 paid,每一步一个动作,规则随之一同流转。这些状态在模型中声明,所以 status 的类型是 Literal['planted', 'harvested', 'delivered', 'paid'],你的编辑器恰好会提供这四个选项。
from datetime import date
wheat = next(h for h in Field.get("hilltop").harvests if h.status == "planted")
mill = Buyer.get("stone-mill")
wheat.record_harvest(harvested_on=date(2027, 7, 28), tonnes=61.5)
wheat.sell_harvest(buyer=mill, price_per_tonne=212)
# ServerError: HTTP 422: No signed delivery note. Without one, the buyer decides later what you delivered.
wheat.sell_harvest(buyer=mill, price_per_tonne=212, delivery_note=True, quality_tested=True)
Buyer.get("stone-mill").unpaid # 13038: what the mill owes you, until …
wheat.record_payment()
Field.get("hilltop").margin # … the wheat lands in the field's margin
一行代码,询问整个农场。谁买了多少干草,逐月,以什么价格。分组、求和和排序都在服务端完成;不会为了计数而下载任何数据到本地。
Sale.aggregate(
sum_(Sale.bales), avg(Sale.price_per_bale), count(),
group_by=[bucket(Sale.sold_on, "month"), by(Sale.buyer)],
order_by=sum_(Sale.bales), desc=True,
).flat()
# [{'sold_on_month': '2025-12', 'buyer': 'Riding stables', 'bales_sum': 80,
# 'price_per_bale_avg': Decimal('4.5000000000000000'), 'count': 2}, …]
金额从数据库开始一路保持 Decimal;不会经过 float 被舍入。
像 {{NAME_ab12cd34}} 这样写的值是真实值的占位符。请按原样使用它们,在回复和工具调用中都是如此:它们会在任何内容运行之前被替换为真实值。不要请求验证它们,也不要用示例替换它们。
标题:Show HN: Sutra-OS – 一个自托管的本体平台
是集合,不是列表。在类上,属性是一个过滤器,链接是一跳。用 |、& 和 - 组合集合;服务器负责规划,你只获取你所迭代的内容。每个集合都知道自己持有什么:running_low 是一个 ObjectSet[Lot],沿 Lot.sales 跳一步就使它变成一个 ObjectSet[Sale]。
running_low = Lot.where(Lot.in_barn < 50)
neighbours = Sale.where(Sale.buyer == "Neighbour").around(Sale.lot)
(running_low - neighbours).count() # 3: running low, and the neighbour never bought from them
running_low.around(Lot.sales).aggregate(sum_(Sale.bales), group_by=[by(Sale.buyer)]) # who emptied them
在今天的农场上试试明天的规则,或者看看上周二的情况。上述所有内容都能在分支上原样运行,而且每个操作都会告诉你它落地在哪个修订版本,这是一个你之后可以再次读取的状态。
with client.branch("new-rule"): # made with: sutra branch new-rule
lot.sell_hay(sale_nr="S-2026-012", buyer="Neighbour", bales=5) # main never notices
sale = lot.sell_hay(sale_nr="S-2026-013", buyer="Neighbour", bales=1)
client.at(sale.revision).objects("sale") # the sales as they stood right then
还有它会拒绝什么。错误的名称、缺失的参数和错误的类型会在你的编辑器中、在任何东西运行之前就失败。损坏的规则会在服务器上失败,并且对每个客户端都给出同一句话。如果模型在你脚下发生变化,register_all 会拒绝运行,直到你重新生成。
lot.sell_hay(bales=20, buyer="Neighbour") # error: Argument missing for parameter "sale_nr"
lot.sell_hay(sale_nr="S-1", buyer="Neighbour", bales="20")
# error: "Literal['20']" is not assignable to "int"
Lot.where(Lot.in_barn < "about forty") # error: Operator "<" not supported for types
# "Property[int]" and "Literal['about forty']"
lot.field.margin # error: "margin" is not a known attribute of "None"
这些是 pyright 针对生成的 farm SDK 给出的消息。该 SDK 的测试用 pyright 运行同样的行,针对的是从一个运行中的服务器捕获的 schema 所生成的 SDK,而不是手写的仿制品。
这一切都不是事后外挂上去的报表层。UI、CLI、REST API 和 agent 都通过同一扇门提出同样的问题、执行同样的操作,这正是为什么一个 agent 可以被交给 Lot 和 sell_hay,除此之外什么都没有。
开发
./bin/start.sh # backend + shadow-cljs watch; PostgreSQL from SUTRA_PG_URL
./bin/stop.sh
(cd tests/frontend && npm install) # once: the browser tests' driver (playwright-core)
bin/test # full suite; integration tiers start PostgreSQL in podman
| 路径 | 存放内容 |
|---|---|
| src/ | 服务器 |
| libs/ | 服务器、客户端和测试共享的库:kernel(参考解释器)、world(作为 db 值的世界)、commits、service、dialect、core、lib(作为库的 .ent 方言)、calx、store、store-pg |
| clients/ | 前端、CLI、语言服务器、Python SDK,以及 bin/change 和 bin/enta 背后的 babashka 工具 |
| plugins/ | 可选模块(SSO、LLM、packages、……) |
| boundaries/ | 已发布的接口、一致性套件及其注册表(resources/sutra/boundaries.edn),Apache-2.0 |
| resources/ | .ent 语法和示例模型(presets)、平台配置、Web 客户端的静态文件 |
| distributions/ | 即用型捆绑包(sutra-solo) |
| tests/ | 后端测试套件、场景,以及 tests/frontend |
| bin/ | start、stop、test 和工具脚本 |
语义由一个可执行场景固定下来,即 tests/scenario 中的一个飞机维修车间:“缺陷未关闭时不得放行”就是上面那条谷仓规则在另一个世界里的版本。
安全:运行普通服务器时设置 SUTRA_HTTP_BIND(它默认是 0.0.0.0)。./bin/start.sh 允许匿名访问,所以绝不要将它暴露出去。Transform 会在服务器上运行用户代码,因此请相应地授予该权限。
贡献
文章标题:Show HN: Sutra-OS —— 一个自托管的本体平台
正文: 招募维护者。Sutra-OS 需要有人长期承担其中一部分的责任:服务器、Web 客户端、Python SDK、连接器、打包与安装、文档,或示例模型。你不需要了解全部内容。先从一个领域的几项贡献开始;如果你想留下来,请在 issue 中说明。
最有用的贡献并不总是代码:
- 一个针对日常问题的模型。租房、养老金、医疗账单、小型协会的会员管理。如果某条规则能保护某个人,它就应该放进 resources/presets。
- 为那些替他人搭建 Sutra 的人编写通俗易懂的指南。
- 翻译。代码库和示例中有部分内容是德语;用户界面应该能说不止两种语言。
- 代码。提交一个失败的测试或一个修复。
有问题、想法和 bug 报告请开 issue。请保持友善:对面那个人可能正是这套东西为之而建的人。
代码按原样提供,本着 Rich Hickey 的《Open Source is Not About You》的精神:没有人有资格要求一个功能、一个修复或一个答复,维护者也不例外。让它持续下去的,是人们选择去帮忙。
致谢
对象、链接和动作的本体模型沿用了 Palantir Foundry 推广的那一套;Sutra-OS 是依据其公开文档构建的。Web 客户端基于 Palantir 的 Blueprint UI 工具包(Apache-2.0)构建,以 ClojureScript 移植版的形式 vendor 在 clients/frontend/vendor/blueprint-cljs 中。本实现的一切都要归功于 Rich Hickey 和 Clojure,以及他那场近乎精神性的演讲《Are We There Yet?》,它或许会继续将软件工艺转化为永恒。所有代码均由 Claude Code 编写。
许可证
AGPL-3.0-or-later,附带第 7 条例外,允许与 EPL 库(如 Clojure)链接。参见 LICENSE。AGPL 意味着,任何将修改过的 Sutra 作为服务提供给他人运行的人,都必须向他们提供源代码,从而让这个工具始终掌握在它所服务的人手中。
未进行任何专利检索。AGPL 仅许可贡献者的专利;在适用的情况下核查第三方专利由你自行负责。Palantir 和 Foundry 是 Palantir Technologies Inc. 的商标;Sutra-OS 是独立的,与 Palantir 无关联,也未获其认可。