Sutra-OS:开源自托管本体平台发布 Beta 版
Show HN: Sutra-OS – A self-hosted ontology platform
Sutra-OS 发布 Beta 版,这是一个开源、自托管的 ontology 平台,用对象类型、链接类型和动作类型三层结构把数据组织成用户自己拥有的模型。所有写入只能通过服务端校验的动作完成,被拒绝的动作不写入任何内容,每个数字都可沿血缘追溯回来源。
稀缺、有类型、有关联、可执行。
一个开源、自托管的本体平台。
你的数据成为一个你拥有的模型:有类型、有关联、只能通过
服务器强制执行的规则来修改,而且每个数字都能追溯到它的来源。
快速开始 · 工作原理 · 提案 · Python SDK · 参与贡献
Beta 版。只有小部分仍处于 alpha 阶段:模型语言和 API 可能 仍会在版本之间变化,部分用户界面和文档 尚未完成。
招募维护者。Sutra-OS 目前仍是一个人的项目。参见 参与贡献。
动机
Sutra-OS 始于 2025 年末的一个思想实验:一个免费版本的 面向本体的软件开发中所描述的系统, 我深深敬佩其创造者。
如今大量人才投入到贩卖注意力的软件中,而其他一切所依赖的 软件大多是免费的:粗略估计, 美国经济产出的 70–90% 在某个关键环节依赖于免费软件。这种开放性 并无保障。2026 年 11 月,Nvidia 的董事会与那位让其 AI 模型 公开释出的创始人分道扬镳。Sutra-OS 以 AGPL 协议 为公共资源添砖加瓦,使其对任何人都保持可读。
过去十年已经表明,当无人能看清什么依赖于什么时,代价有多高。 2017 年,NotPetya 通过一个乌克兰会计程序传播, 让 Maersk 的港口和 Merck 的工厂停摆。2023 年,一个 FAA 系统中的损坏文件让美国所有国内航班停飞。 2024 年,一次有缺陷的 CrowdStrike 更新让数百万台 Windows 机器崩溃, 航空公司、医院和银行陷入停滞。2026 年 11 月,一个 供应商让 Outlook 宕机一天,一些城市退回到传真。同一周, 数据淹没了 FAA 的电信网络,老化的路由器不堪重负, 美国经历了历史上仅第三次全国性停飞。 似乎没有人把这些路由器列入维持飞机飞行的 地图之中,所以没有人能事先问清:如果它们失效,什么会停止。
这个问题正是 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)。管理员密码就在那里的 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}]]
销售指明它所属的批次,链接随之而来:从批次可以看到它的销售,从销售可以看到它的批次,而上面的 :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 代理使用同一句话。被拒绝的动作不会写入任何内容。每笔销售都会记录是谁做的,没有人能把别人的名字放在那里。
动作是唯一的写入路径:类型化参数、验证、提交条件和状态转换,一次定义,处处执行。
你原本记在脑子里的每条规则都有这样的形态:一个由服务器计算的事实,以及一个检查它的动作。声明一次,就不必再记。
同样的三个理念也贯穿农场的耕作侧。一块地的利润来自它已付款的收成和卖出的干草,相隔两个链接。一次收成从已种植到已收获、已交付和已付款,只能通过它的动作推进,而出售收成在没有签名的交付单和你自己的质量检测时拒绝运行。
你不发话,什么都不会发生
在大多数软件里,决定和执行是一步。在 Sutra 里是两步。当你出售干草时,服务器先写下将会改变什么:一笔新销售,四十捆,你的名字在上面。此时什么都还没发生。只有那张单据被批准后,谷仓才会改变。
其余一切都由此而来:
- 你总能先问。“这样行得通吗?”是同一个问题,只是少了最后一步。
- 代理只能提建议。它交回的是单据,绝不是变更。由你决定。
- 你可以先试。在副本上运行同样的决策,比较,并让真实的那份保持不动。
- 你可以回看。每一次获批的变更都被保留,所以上周二的状态仍然可以读取。
- 答案处处相同。规则只在一个地方检查,所以手机、脚本和代理听到的是同一个不。
而且这不是一句承诺。如果负责决定的部分做了决定之外的任何事,测试就会失败。
更多能力
-
你的数据原样进来。通过 IMAP 收邮件,CSV 导出,REST API,PostgreSQL、MySQL、SQL Server 和 SSH,用 Python、SQL 或 Clojure 中的转换来塑形。
-
每个数字都有来历。血缘从每个对象回溯,穿过转换和数据集,直到它来自的邮件、对账单或数据行(
sutra lineage <node>)。当别人的数字与你的不一致时,你打开源头。 -
代理只拿到你点名的工具。一个动作、一个函数、对一种类型的查询。默认情况下(
:writes :propose)它们的变更会作为提案暂存;被拒绝的不会回来,模型的提示词和回答随运行一起保留。 -
模型像代码一样被版本化。模型和数据都活在分支上。你暂存变更、提交、发起提案、查看谁消费了你触碰的东西,并且只有在评审后才合并进
main。除非你另有说明,Webhook 和通知在分支上保持沉默。 -
只分享你选择的内容。类型和属性上的标记是强制访问控制;项目上的授权决定谁可以读取、执行和调用。一个群体(合作社、租户协会、家庭)可以汇集其成员同意分享的内容,仅此而已,服务器在每次读取时强制执行:列表、过滤、计数和总计。一个人的数据不能显示其他人被提供了什么。一个群体的可以。
-
构建者和用户是不同的人。一个人编写模型;其他人拿到的是构建工具被锁起来的应用,以及一个在“不”是正确答案时说不的服务器。
-
机密保持不可触及。一个独立的出口代理持有所有外部凭据,所以读取你邮件的代码永远看不到密码。
模型即 SDK
你曾经描述过这个农场。用它生成一个 Python SDK,你的代码就能说农场的语言:地块、收获和买家,以及你被允许对它们做的事情,而不是表和连接。
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:每个对象类型一个类,每个属性和链接一个特性,每个动作一个方法,动作的参数就是它的签名。Sutra 的语言服务器(clients/ent-lsp)为 Python 运行 pyright,并把每个补全项标注为它在模型中的身份(属性、链接类型、动作、状态);任何允许你选择语言服务器的编辑器都能运行它(Neovim 配置)。
动作就是方法。它的签名来自模型;缺少参数会在任何东西运行之前被标记出来。
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'],所以编辑器恰好提供那四种。
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)
过滤器也会被检查。用字符串比较捆数,或读取一个可能为空的链接,会在编辑器中失败,而不是在农场上。
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="…"))
是对象,不是行。一个地块会带上它的派生值和它的链接。没有人存储 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.sell_hay(sale_nr="S-2026-010", buyer="Neighbour", bales=20, price_per_bale=4.50) Lot.get(lot.name).in_barn # 5
先询问,或只提议。同一个调用可以是一个问题(不写入任何东西)或一个提议(暂存直到有人批准)。这就是代理使用它的方式。
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
走完一个生命周期。一次收获从已种植到已收获、已交付和已付款,每一步一个动作,规则随它们一起走。状态在模型中声明,所以 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;没有任何东西通过浮点数被舍入。
是集合,不是列表。在类上,属性是过滤器,链接是一跳。用 |、& 和 - 组合集合;服务器规划它,你只获取你迭代的内容。每个集合知道它持有什么: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 针对生成的农场 SDK 的消息。SDK 的测试通过 pyright 运行相同的行,针对的是从运行中的服务器捕获的模式生成的 SDK,而不是手写的模仿。
这些都不是事后附加的报告层。UI、CLI、REST API 和代理通过同一扇门问相同的问题并采取相同的动作,这就是为什么可以只交给代理 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(作为数据库值的世界)、commits、service、dialect、core、lib(作为库的 .ent 方言)、calx、store、store-pg |
clients/ |
前端、CLI、语言服务器、Python SDK,以及 bin/change 和 bin/enta 背后的 babashka 工具 |
plugins/ |
可选模块(SSO、LLM、包等) |
boundaries/ |
已发布的接口、一致性套件及其注册表(resources/sutra/boundaries.edn),Apache-2.0 |
resources/ |
.ent 语法和示例模型(presets)、平台配置、Web 客户端的静态文件 |
distributions/ |
可直接运行的打包(sutra-solo) |
tests/ |
后端测试套件、场景,以及 tests/frontend |
bin/ |
启动、停止、测试和工具脚本 |
语义由一个可执行场景固定下来,即 tests/scenario 中的飞机维修车间:“有缺陷未关闭就不得放行”正是上文谷仓规则在另一个世界中的体现。
安全:运行普通服务器时请设置 SUTRA_HTTP_BIND(其默认值为 0.0.0.0)。./bin/start.sh 允许匿名访问,因此绝不要将其暴露。
转换会在服务器上运行用户代码,因此请相应地授予该权限。
贡献
招募维护者。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 移植版的形式内置在
clients/frontend/vendor/blueprint-cljs 中。
本实现的一切都要归功于 Rich Hickey 和 Clojure,以及他那场近乎精神性的演讲
Are We There Yet?,
它或许会继续将软件工艺转化为永恒。
Claude Code 编写了全部代码。
许可证
AGPL-3.0-or-later,并附有第 7 条例外,允许与 Clojure 等 EPL 库链接。参见 LICENSE。AGPL 意味着任何将修改后的 Sutra 作为服务提供给他人运行的人,都必须向他们提供源代码,从而让该工具始终掌握在它所服务的人手中。
未进行任何专利检索。AGPL 仅许可贡献者的专利;在适用的情况下检查第三方专利由你自行负责。Palantir 和 Foundry 是 Palantir Technologies Inc. 的商标;Sutra-OS 是独立项目,与 Palantir 无关联,也未获其认可。
来源:Hacker News · github.com







