Substr8命令行界面
](https://pypi.org/project/substr8/) 
可验证的人工智能基础设施 --AI代理的治理平面。
Substr8为AI代理提供了可证明、可审计和确定性的基础设施。任何可以调用工具的框架都可以插入Substr8。
Substr8做什么
| 问题 | Substr8解决方案 |
|---|---|
| 运行哪个版本的代理? | FDAA --文件驱动代理架构 |
| 它被允许这样做吗? | 自适应巡航控制 --代理能力控制 |
| 它到底做了什么? | DCT --篡改明显的审计分类账 |
| 它记得什么? | 广义可加模型 --Git本机代理内存 |
| 对话有效吗? | 中央情报局 --对话完整性保证 |
| 我该如何部署它? | 网关 --Docker Swarm编排 |
安装
pip install substr8快速开始
面向开发人员(任何框架)
将您的LangGraph、AutoGen、PydanticAI或自定义代理连接到Substr8:
# Start the MCP governance server
substr8 mcp start --local
# In another terminal, run your agent
python my_agent.py # calls Substr8 MCP tools您的代理调用MCP工具,例如 substr8.run.start, substr8.policy.check, substr8.memory.write。每个操作都经过策略检查和记录。
运营商(基础设施)
部署完整的Substr8堆栈:
# Start the gateway (OpenClaw runtime + governance services)
substr8 gateway start
# Check status
substr8 gateway status______________________________________________________________________
命令组
substr8 mcp --MCP治理服务器
MCP服务器将Substr8治理作为任何框架都可以调用的工具公开。
substr8 mcp start [--local] [--require-auth] [--port 3456]
substr8 mcp stop
substr8 mcp status
substr8 mcp tools # List available MCP tools12个MCP工具:
| 类别 | 工具 |
|---|---|
| RIL(运行时) | run.start, run.end, tool.invoke |
| ACC(政策) | policy.check |
| DCT(审计) | audit.timeline, verify.run |
| GAM(内存) | memory.write, memory.search |
| CIA(诚信) | cia.status, cia.report, cia.repairs, cia.receipts |
使用Auth+速率限制:
# Require API keys
substr8 mcp start --local --require-auth
# Call with key
curl -H "X-Substr8-Key: sk-substr8-xxx" http://localhost:3456/tools/run/start速率限制:免费(100/min)、专业版(1000/min)、企业版(10000/min)
______________________________________________________________________
substr8 gateway --基础架构编排
管理Substr8运行时的Docker Swarm堆栈。
substr8 gateway start # Deploy OpenClaw + FDAA proxy + services
substr8 gateway stop # Tear down stacks
substr8 gateway status # Health check all services
substr8 gateway logs # View service logs它部署了什么:
- OpenClaw运行时(编译markdown代理→ 系统提示)
- FDAA代理(用于LLM调用的CIA中间件)
- GAM服务(有来源的内存)
- Postgres/pgvector(嵌入)
何时使用: 您正在运行自己的Substr8基础架构(自托管)。
______________________________________________________________________
substr8 dev --开发者脚手架
创建启动项目和演示。
substr8 dev init # Scaffold example agents in current directory
substr8 dev demo # Run a complete demo (start → agent → audit)什么 dev init 创建:
my-project/
├── examples/
│ ├── langgraph/agent.py
│ ├── pydantic-ai/agent.py
│ └── autogen/agent.py
├── .env.example
└── README.md何时使用: 您正在启动一个使用Substr8的新项目。
______________________________________________________________________
substr8 gam --Git本机代理内存
使用加密来源管理代理内存。
substr8 gam init # Initialize repository
substr8 gam remember "text" --tag x # Store a memory
substr8 gam recall "query" # Search memories
substr8 gam verify # Verify provenance
substr8 gam status # Show status______________________________________________________________________
substr8 fdaa --代理身份和注册
包、版本和注册代理。
substr8 fdaa hash
# Hash an agent bundle
substr8 fdaa register
# Register with FDAA registry
substr8 fdaa verify # Verify agent integrity______________________________________________________________________
substr8 acc --能力控制
管理代理策略。
substr8 acc policy list # List policies
substr8 acc policy check # Check if action is allowed______________________________________________________________________
substr8 dct --审计分类账
查询防篡改日志。
substr8 dct timeline # Get audit trail
substr8 dct verify # Verify chain integrity______________________________________________________________________
命令如何协同工作
# 1. OPERATORS: Deploy infrastructure
substr8 gateway start
# 2. DEVELOPERS: Start governance server
substr8 mcp start --local
# 3. DEVELOPERS: Scaffold a new project
mkdir my-agent && cd my-agent
substr8 dev init
# 4. DEVELOPERS: Run your agent
python examples/langgraph/agent.py
# 5. ANYONE: View audit trail
substr8 dct timeline run-abc123______________________________________________________________________
建筑
┌─────────────────────────────────────────────────────────┐
│ Your Agent Framework │
│ (LangGraph, AutoGen, PydanticAI) │
└─────────────────────────┬───────────────────────────────┘
│ HTTP tool calls
▼
┌─────────────────────────────────────────────────────────┐
│ Substr8 MCP Server │
│ (substr8 mcp start) │
├─────────────────────────────────────────────────────────┤
│ RIL │ ACC │ DCT │ GAM │ CIA │
└───────┴───────┴───────┴───────┴─────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Substr8 Gateway │
│ (substr8 gateway start) │
├─────────────────────────────────────────────────────────┤
│ OpenClaw │ FDAA Proxy │ Postgres │ GAM Service │
└────────────┴──────────────┴────────────┴────────────────┘______________________________________________________________________
托管端点
| 终点 | 目的 |
|---|---|
mcp.substr8labs.com | 托管MCP服务器(即将推出) |
fdaa.substr8labs.com | 代理注册表+身份 |
______________________________________________________________________
研究
| 纸张 | DOI |
|---|---|
| FDAA:文件驱动代理架构 | 10.5281/zenodo.18675147 |
| ACC:代理能力控制 | 10.5281/zenodo.18704577 |
| GAM:Git本机代理内存 | 10.5281/zenodo.18704573 |
______________________________________________________________________
链接
- 网站: subst8labs.com
- 博客: subst8labs.substack.com
- github:
- 推特: @subst8labs
______________________________________________________________________
许可证
麻省理工学院-- Substr8实验室
*框架运行代理。Substr8证明了他们的所作所为。*
